Adams Advanced Package > Adams Vibration > Dialog Box - F1 Help > Create Vibration Design Objective Macro

Create Vibration Design Objective Macro

Vibration -> Improve -> Vibration Design Object -> New/Modify or
Simulate -> Design Objective -> New/Modify -> View Variable and Vibration Macro

Creates a macro capable of retrieving vibration-specific data. You can then use it when performing a design study.

For the option:	Do the following:
Tips on Entering Object Names in Text Boxes
Macro Name	Specify the name of the macro you are creating.
Return Value Variable	Specify the name of the variable you want to use in your design study.
Target Vibration Data	Select one of the following options:
	This option:	Returns:
	Frequency Response: 1 Input, 1 Output	A minimum or maximum value of the frequency response curve.
	Frequency Response: All Inputs, 1 Output	A minimum or maximum value of the frequency response curve.
	Freq. Resp. Magnitude of sums: 1 Input, Multiple Outputs	A minimum or maximum value of the frequency response curve for each pairing of the input channel with the multiple output channels. The minimum or maximum values are summed, and used as the return value for the design objective macro. See Example: Freq. Resp. Magnitude of sums: 1 Input, Multiple Outputs
	Freq. Resp. Magnitude of sums: All Inputs, Multiple Outputs	Same as above, except all input channels are used together (you do not specify the input channels themselves). See Example: Freq. Resp. Magnitude of sums: All Inputs, Multiple Outputs
	Freq. Response Area: 1 Input, Multiple Outputs	The sum of the areas beneath the frequency response curves for each pairing of the input channel with the output channels. See Example: Freq. Response Area: 1 Input, Multiple Outputs
	Freq. Response Area: All Inputs, Multiple Outputs	Same as above, except all input channels are used together (you do not specify the input channels themselves). See Example: Freq. Response Area: All Inputs, Multiple Outputs
	Frequency Response Error: 1 Input, 1 Output	The sum, maximum, or average error between the test data you provide and a one input / one output Frequency Response calculation.
	Frequency Response Error: All Inputs, 1 Output	The sum, maximum, or average error between the test data you provide and an output frequency response calculation.
	PSD: 1 Output	A minimum or maximum value of the frequency response curve.
	Modal Participation: 1 Input, 1 Output	A minimum or maximum value of the frequency response curve.
	Eigen Natural Frequency Error	The amount of error between the test value you provide and the natural frequency value for a particular mode number in the eigen solution.
	Eigen Real Part	The eigen solution's real part for a specified mode.
	Eigen Imaginary Part	The eigen solution's imaginary part for a specified mode.
	Eigen Damping Ratio	The eigen solution's damping ratio for a specified mode.
	Modal Energy: Normalized Coordinates	The modal energy normalized coordinates value for a specified object.
	Modal Energy: Kinetic Energy	The modal energy kinetic energy value for a specified object.
	Modal Energy: Strain Energy	The modal energy strain energy value for a specified object.
	Modal Energy: Dissipative Energy	The modal energy dissipative energy value for a specified object.
Depending on how you set Target Vibration Data, Adams Vibration may display the following options:
Input Channel	Enter the input channel you want to use in your macro.
Output Channel	Enter the output channel you want to use in your macro.
Value Type	Specify one of the following: ■Minimum (Sum of Minimums) - Uses minimum (sum of minimum) values. ■Maximum (Sum of Maximums) - Uses maximum (sum of maximum) values.
Frequency Range	Select one of the following: ■All Frequencies - Use all frequencies from your frequency response calculation. ■Specific Range - Enter a range of frequencies.
Test Data	Enter a result set component that represents your test data. This data may have been created by the file testdata read or other actions that can create results set components. The number of values you provide should be the same as the number of frequencies used for the frequency response calculation.
Error Type	Specify how you want the error value to be computed. The basic process is to take the frequency response curve that is obtained using the Input Channel and Output Channel values and then see how it differs from the curve obtained from the Test Data. Select one of the following: ■Sum - The absolute values of the differences between the curves at each of their points are added together to yield the error value. ■Maximum - The maximum difference between the curves represents the error value. ■Average - The absolute values of the differences between the curves at each of their points are added together and then averaged to yield the error value.
Mode Number	Enter the mode number of interest.
Test Value	Enter the target value. The absolute value of the difference between the test value and the natural frequency for the specified mode will be the return value for the macro.
Object Type	Select an object type.
Object Name	Enter the name of the object of interest.
Component/State	Depending on the Object Type you selected, Adams Vibration will display the Component pull-down menu or the State text box: ■Component - Select an object component. ■State - Enter an integer for the state of interest.
Body Name	Enter the name of the body of interest.
Component	Select an object component.