*SetFrequencyInput()

Set properties for a FrequencyInput entity.

Syntax

*SetFrequencyInput(varname, type, amplitude, phase_angle, [x], [y], [z], [rx], [ry], [rz]))

Note: [] indicates optional arguments

Arguments

varname: The variable name of an existing FrequencyInput entity.; Data type: varname
type: This argument specifies the type of FrequencyInput as Force, Displacement, Velocity or Acceleration.; Data type: String; Valid values: DISP|VEL|ACCEL|FORCE
amplitude: Amplitude of the FrequencyInput.; Data type: NonLinear; Default: LIN, 0.0
phase_angle: The phase angle of the FrequencyInput.; Data type: NonLinear; Default: LIN, 0.0
x,y,z: The translational directions at which a frequency input can be applied. If false, there is no frequency input component at the certain direction.; Data type: Boolean; Default: false
rx,ry,rz: The rotational directions at which a frequency input can be applied. If false, there is no frequency input component at the certain direction.; Data type: Boolean; Default: false

NonLinear

The NonLinear datatype is used with a TYPE, TOKEN/S combination. TOKENS follows TYPE separated by comma. A particular TYPE of NonLinear entry may need more than one token.


TYPE	TOKEN/S	Comments
`LIN,`	`lin`	Where `lin` is a constant (real) value.
`CRV,`	crv, int_type,`indep_var`	The value is characterized using a Curve. `crv` is the variable name of an existing Curve entity. `int_type` is the interpolation method and can be set to either AKIMA, CUBIC, LINEAR, or QUINTIC. `indep_var` is a valid solver expression used as the independent variable to interpolate the curve.
`SPL3D,`	spl,int_type,`indep_var`,`indep_var2`	Value is a 3D spline. `spl` is the variable name of an existing Spline3D entity. `int_type` is the interpolation method and can be set to either AKIMA, CUBIC, LINEAR, or QUINTIC. `indep_var` and `indep_var2` are valid solver expressions used as the independent variables to interpolate the spline3D.
`EXPR,`	`expr`	Value is a valid solver expression.

EXPR: TOKEN: expression; Enter an expression

Example

*BeginMDL( the_model, "Model")
  *Point( p_susp, "SuspensionMassCG" )
  *Body( b_susp, "SuspensionMass", p_susp, , , ,  )
  *FrequencyInput( freqinput1, "FrequencyInput 1", b_susp, p_susp, Global_Frame ) 

//In the following statement, the frequency input is of type FORCE, the amplitude and phase_angle is given as a constant value
  *SetFrequencyInput(freqinput1, FORCE, LIN, 1, LIN, 1) 
  *Curve( crv_amplitude, "Amplitude")
  *Curve( crv_angle, "Phase Angle")

//In the following statement, The amplitude and phase_angle are using curves with FREQ as the independent variable expression. The y and z directions are turned on.
  *SetFrequencyInput(freqinput1, DISP, CRV, crv_amplitude, LINEAR, `FREQ`, CRV, crv_angle, 
   CUBIC, `FREQ`, , true, true)
  *Spline3D(spl3d_amplitude, "Amplitude")
  *Spline3D(spl3d_angle, "Phase Angle")

//In the following statement, the frequency input is of type VEL. The amplitude is input using a 3D Spline with AKIMA interpolation, FREQ as the first independent variable expression and {j_trans.DX} as the second independent variable expression. Phase angle uses a curve crv_angle.
  *SetFrequencyInput(freqinput1, VEL, SPL3D, spl3d_amplitude, AKIMA, `FREQ`, 
   `{j_trans.DX}`, CRV, crv_angle, AKIMA, `FREQ`, , true, true)

//In the following example, the amplitude is using an solver expression and phase angle a constant value.
  *SetFrequencyInput(freqinput1, DISP, EXPR, `STEP(FREQ,0.01,1,10,100)-STEP(FREQ,10,0,20,99)`,
   LIN, 1, , TRUE, TRUE)
*EndMDL()

Context

Comments

When none of the x,y,z,rx,ry,rz are specified, the frequency input is applied in the X direction.