Documente Academic
Documente Profesional
Documente Cultură
Welcome to Adams/Durability
22 Adams/Durability
Introduction to Adams/Durability
Introduction to Adams/Durability
Adams/Durability, part of the Adams 2014 suite of software, extends the traditional test-based
durability design process into the virtual world. With Adams/Durability, you can simulate a durability
duty cycle and write out component load histories in or formats and drive a durability test rig using
output data in RPC III Format or DAC Format. You can visualize stress or detect hot spots in flexible or
rigid components, and you can improve component design by interfacing with fatigue life prediction
programs.
Some of the features of Adams/Durability are available as a demand-loaded library (DLL), while the rest
are available as a plugin to the various Adams interface or vertical products, such as Adams/View,
Adams/PostProcessor, and Adams/Car.
output in RPC III and DAC formats. For example, when you perform a 25-second Adams
simulation with 300 channels of data, sampled at a rate of 409.6 points per second, to capture a
durability event, the Adams Request files are approximately 48 MB, whereas the RPC III file is
only 6 MB.
Provides access to the system-level simulation capabilities of Adams/View, or vertical products,
such as Adams/Car.
Provides access to dynamic stress recovery methods using NASTRAN or ANSYS.
Performs modal stress recovery of flexible bodies.
Provides access to component life prediction using MSC.Fatigue or FE-Fatigue.
Welcome to Adams/Durability 23
Introduction to Adams/Durability
the RPC III format. Then, you can write out component load histories in DAC format for subsequent
component durability testing or fatigue life prediction.
You can perform the following with DAC or RPC III files:
Browse the files for header information, such as number of time steps, sample rate, number of
24 Adams/Durability
Introduction to Adams/Durability
26 Adams/Durability
AUTOQSET cannot be used for the primary run due to the limitation of MSC.Nastran
restart capability
Restarting NASTRAN
A restart MSC.Nastran for modal stress recovery needs to be specified at the top of the MSC.Nastran
input deck in the file management section:
ASSIGN <logical name>='<database name>'
RESTART LOGICAL=<logical name>
where <logical name> is the logical name of the database to be assigned and <database name>
is MASTER file name of the primary run. Note that the logical name is arbitrary characters within 8
letters and first one should be alphabet.
28 Adams/Durability
Results Postprocessing
Dynamic stress/strain output can be either in F06, PUNCH OUT, XDB or OUTPUT2 according to
standard MSC.Nastran functionality, and the output files can be postprocessed in Patran or SimXpert
Structures.
If displacements, stresses, and/or strains are to be available for postprocessing, one or more of the
following statements must appear in the case control section of the MSC.Nastran input file:
DLOAD = <load id>
DISP(PLOT) = <set id>
STRAIN(FIBER,PLOT) = <set id>
STRESS(PLOT) = <set id>
where <load id> is a ID number indicated by ASSIGN statement in the executive control section, and
<set id> is a ID number defined in SET statement.
PARAM, ADMPOST
Request modal stress recovery (see the MSC.Nastran quick reference guide for more information):
0: Modal stress recovery is not activated (default)
1: Request modal stress recovery without rigid body motion
2: Request modal stress recovery with rigid body motion
This parameter is used to activate modal stress recovery and control the addition of rigid body motion
with modal deformations. Rigid body motions from an Adams simulation are included in the modal
deformations file (MDF), but they are not applied unless this parameter is set to 2. Including rigid body
motion affects the display or animation of the flexible component, but it has no effect on dynamic
stresses.
PARAM, POST
Request stress/strain/displacement output for postprocessing (see the MSC.Nastran quick reference
guide for more information):
<= 0: Yes
> 0: No
Note that "plate.cmd" is the command file to create the example model with the flex body (MNF) by
"plate.dat" and run the dynamic simulation.
ASSIGN PRIMARY='plate.MASTER'
RESTART LOGICAL=PRIMARY
ASSIGN INPUTT2='plate.mdf' UNIT= 31
SOL 103
SOL 112
CEND
CEND
$ GLOBAL CASE
$ GLOBAL CASE
METHOD = 1
METHOD = 1
Restart setting
Read MDF
ADAMSMNF FLEXBODY=YES
DLOAD = 31
DISP(PLOT) = ALL
STRESS(PLOT) = ALL
BEGIN BULK
BEGIN BULK
PARAM, ADMPOST, 2
PARAM, POST, -1
$
GRID, 1, , 0.0, 0.75, 0.0
GRID, 1, , 0.1, 0.75, 0.0
ENDDATA
ENDDATA
Parameter setting
30 Adams/Durability
32 Adams/Durability
34 Adams/Durability
Exporting Data 47
Exporting Data
48 Adams/Durability
Exporting Data 49
Exporting Data for ANSYS
50 Adams/Durability
Exporting Data 51
Exporting Data for NASTRAN
52 Adams/Durability
Exporting for nCode
The online help will not discuss the entire functionality of nCode, only those features that
specifically apply to exporting data. For more detailed information on nCode, refer to your
nCode documentation on FE-Fatigue.
Exporting Data 53
Exporting to RPC III or DAC
Result set components can come from result sets, measures, or requests.
54 Adams/Durability
Setting Up Requests
Setting Up Requests
You can create Requests to output RPC III Format or DAC Format files. You do this before you execute
the simulation.
To set up a request:
1. Define desired requests.
2. From the Settings menu, point to Solver, and then select Output to display the Solver Settings
dialog box.
3. Set Save Files to Yes.
4. Set Graphics File, Request File, and Results File to No if these files are not needed.
5. In the File Prefix text box, enter the name of the model or some other meaningful name.
6. Select More.
7. Set Output Category to Durability files.
8. Set either of the following to On:
DAC Files
RPC File(s)
Exporting Data 55
Simulating the Model
56 Adams/Durability
8. Use Adams/PostProcessor to compare the virtual data to the physical test data (see Plotting Data).
If system response looks better, you can input these data to durability analysis programs and
compare them to the results you obtained from the physical test data. Otherwise, make further
model modifications and simulate again.
58 Adams/Durability
Setting Up a Spline
With Adams/Durability, the SPLINE statement includes arguments that let you input RPC III Format or
DAC Format time history data files. These data files provide one dependent variable and one independent
variable, TIME, as a fixed-time interval. Because RPC III files support multiple channels of data in a
single file, you must specify a channel for this type of file. DAC time history files only have a single
channel of data in a file.
The SPLINE statement, as it appears for durability analysis, looks like:
SPLINE/id, FILE=path [, CHANNEL=n]
Where:
id is the identifier of the spline.
path is the absolute or relative path to the RPC III or DAC file. These files may have any file
extension. Adams/Solver reads the file header to determine the file type.
n is the channel number. This parameter is required for RPC III files, even if the file only has a
single channel. This parameter should not appear for DAC files.
60 Adams/Durability
62 Adams/Durability
User Functions
User Functions
You can use functions in Adams/Durability to interrogate a flexible or rigid body for useful stress, strain,
or life data. The user functions are:
HOT_SPOTS
LIFE
MAX_STRESS
TOP_SPOTS
These functions facilitate the definition of a design objective or variable that can be used in a design of
experiments (DOE) or optimization study. When Adams/Durability is loaded, you can find these
functions in the Misc. Functions category of the Adams/View Function Builder.
HOT_SPOTS
Returns all of the spots on the body that exceed the specified threshold. The spots returned are sorted from
hottest to lowest. This function is useful for obtaining information on all hot spots on a body. A hot spot
is defined as a point where the stress exceeds a certain defined limit (threshold). The Assist dialog box
for the HOT_SPOTS (see Array HOT_SPOTS (Name array, Integer array, Real array)) function is
available in the Adams/View Function Builder.
Radius defines the distance between spots (that is, the spherical region that is considered one spot) on the
body. A value of zero (0) considers all points (nodes) of the body as a unique spot.
The figure below shows a close up of the hottest region of stress on a flexible body. This illustrates how
the radius can affect the definition of a hot spot region. In this figure, the top seven hottest nodes (those
with the largest stress) are listed. If seven hot spots or a threshold of 100 is specified with no (zero) radius,
all of these nodes would be returned by the user function. If a radius of 0.5 mm is specified, only node
four from this region would be returned, and the remaining hot spots would come from nodes with the
highest stress from other regions.
A 6-by-N array is returned, where N is the number of hot spots. The X, Y, Z, Time, Value, and Node are
the columns in the array. Coordinate data is returned in the local part reference frame (LPRF) of the body.
64 Adams/Durability
HOT_SPOTS
Value is the maximum value of the hot spot for the analysis. Time is the actual time of the analysis that
the maximum value occurred. The number of spots found is defined as the number of rows in the array.
If no value exceeding the threshold is found for the body, HOT_SPOTS returns an array with one row of
the hottest spot. If the body or analysis does not exist, or the type of data does not exist for the specified
body, HOT_SPOTS issues an error message and returns an array with one row filled with zeros.
Example
Suppose you want to locate hot spots in a part called shaft, where the maximum von Mises stress is higher
than 700 MPa for the analysis named engine_stall. And, you only want to consider points that are 25
millimeters apart from the other hot spots. After creating a rigid stress object for the part, you can use the
following Adams/View command:
VAR SET VAR=hotspots REAL=(EVAL(HOT_SPOTS({shaft,engine_stall},
{0,1}, {700.0,25.0})))
Note that it is not necessary to define all elements in each array argument explicitly. For example, if
engine_stall was the default analysis run, and because the default setting for stress is 1, you could
simplify the above command to:
VAR SET VAR=hotspots REAL=(EVAL(HOT_SPOTS(shaft, 0, {700,25})));
LIFE
Returns the minimum life of a flexible body for the specified analysis. Results from FE-Fatigue or
MSC.Fatigue for the flexible body need to be imported before using this function. If no fatigue data are
available, the function returns 0 (zero). The analysis argument is optional. The default analysis is used if
one is not given. The Assist dialog box for the LIFE function (see Real LIFE (FlexBody [, Analysis])) is
available in the Adams/View Function Builder.
66 Adams/Durability
MAX_STRESS
MAX_STRESS
Returns the maximum value of stress for the body for the default analysis. The last-run analysis is the
default analysis. If the body does not exist or does not contain stress data, or there is no default analysis,
MAX_STRESS issues an error message and returns a zero. The Assist dialog box for the MAX_STRESS
function (see Real MAX_STRESS (Body, Criterion)) is available in the Adams/View Function Builder.
Example
The following Adams/View command (see Adams/View command file) will set the maximum principal
stress of the flexible body named link in the current model for the last-run analysis to the variable
maxstress. Because units of stress are equivalent to pressure, maxstress will also have the correct units
associated with the variable.
VAR SET VAR=maxstress REAL=(EVAL(MAX_STRESS(link, 7)))
UNITS=PRESSURE;
TOP_SPOTS
Returns a fixed number of the hottest spots in the body. The Assist dialog box for the TOP_SPOTS
function (see Array TOP_SPOTS (Name array, Integer array, Real array)) is available in the Adams/View
Function Builder.
Count is the number of hot spots to locate. If Count is zero, TOP_SPOTS uses Percent to determine the
number of hot spots to return based on the total number of points nodes in the body. If both Count and
Percent are zero, then TOP_SPOTS issues an error message and returns an array with one row filled with
zeros.
Radius defines the distance between spots (that is, the spherical region that is considered one spot) on the
body. A value of zero (0) considers all nodes of the body as a unique hot spot.
The figure below shows a close up of the hottest region of stress on a flexible body. This illustrates how
the radius can affect the definition of a hot spot region. In this figure, the top seven hottest nodes (those
with the largest stress) are listed. If seven hot spots or a threshold of 100 is specified with no (zero) radius,
all of these nodes would be returned by the user function. If a radius of 0.5 mm is specified, only node
four from this region would be returned, and the remaining hot spots would come from nodes with the
highest stress from other regions.
68 Adams/Durability
TOP_SPOTS
TOP_SPOTS returns a 6xN array. X, Y, Z, Time, Value, and Node occupy the columns in the array.
Coordinate data is returned in the local part reference frams (LPRF) of the body. The number of spots
TOP_SPOTS found is the number of rows in the array.
If the body or analysis does not exist, or no data of the specified type is available for the body,
TOP_SPOTS issues an error message and returns an array with one row filled with zeros.
Examples
Use the following Adams/View commands (see Adams/View command file) to return the maximum
principal stress in the link, as well as the node and time that the peak stress occurred:
VAR
VAR
VAR
VAR
SET
SET
SET
SET
VAR=topspot REAL=(EVAL(TOP_SPOTS(link,{7,1},{0,0.0},1)));
VAR=maxstress REAL=(topspot.real_value[5]) UNITS=PRESSURE;
VAR=maxnode INT=(topspot.real_value[6]);
VAR=maxtime REAL=(topspot.real_value[4]) UNITS=TIME;
Similarly, the location of maximum stress could also be extracted from the returned array as real values
1, 2, and 3
36 Adams/Durability
[ S ]' = [ A R ] T [ S ] [ A R ]
where:
[ A R ] is the skew-rotation matrix from the flexible bodys LPRF (FE origin) to the markers
coordinate reference
where
Sij = Sji
(1)
(2)
[ C ] :
[ C ] = [ k II ] l [ k IB ]
(3)
[ 2 [ m II ] + [ k II ] ] { I }
yielding the normal modes matrix
(4)
[ N ] :
[ N ] = [ { I } 1, ..., { I } P ]
(5)
From equation (5), a subset of the N normal modes is considered, and the physical coordinates are
calculated as a linear combination of the mode shapes.
xB
[ I ] { 0 } qB
{x} = =
= []{ q}
[ C ] [ N ] qI
xI
where:
{x} is the vector of physical displacements
(6)
38 Adams/Durability
modes
Now, equation (1) can be rewritten as:
B
BB
BN q
BB
qB
fB
m
k
0
m
[M]{q } + [K]{ q} =
I +
I = I = { f }
NB
NN q
NN
q
f
m m
0 k
(7)
An ortho-normalization of the reduced system described by equation (7) is performed while translating
from each FE output file into the Adams modal neutral file (MNF). The effect is to obtain a diagonal
model and to associate a frequency content to the static correction modes as well.
FEM structural analysis obtains the modal and static information needed to perform modal reduction, in
a sequence of static load cases with varying boundary conditions, as described in equation (1).
Adams assembles and solves fully inertially coupled equation of motion of the mechanical system
including the flexible part(s). It also adds the generalized modal coordinates as unknowns. Adams/Solver
manages the full set of equations giving the parts rigid body coordinates and modal coordinates as a
result. Adams/Solver also computes the reaction forces acting on the flexible component through
algebraic constraint or external forces.
Once Adams/Solver has computed the set of modal coordinates, it is possible to recover stress in the FE
code using equation (6) and pass the physical displacements to the FE code. Strains and stresses would
then be recovered in the FE code from the solution of
{ X } by:
{ } = [B]{x}
(8)
{} = [E]{}
(9)
where:
Note that this can be a very inefficient solution for large meshes and when a large number of time steps
are involved. In addition, this method is dependent on the Adams solution and, therefore, not conducive
to system studies, such as DOE or optimization.
{ } = [ ] { q }
(10)
where:
[ ] = [ E ] [ B ] [ ]
(11)
and:
[ ] = [ { } 1, ..., { } P + S ]
Here,
(12)
[ ] is the ortho-normalized modal stress matrix that identifies the stress component associated
{ } = []{ q}
and
[ ] = [ B ] [ ]
where:
[ ] is the ortho-normalized modal strain matrix identifying the strain component associated
with each orthogonalized mode shape
40 Adams/Durability
{ }' = { 0 } + [ ] { q }
where:
{ 0 } is the prestress state due to preload. This vector also needs to be computed by the FE code and
stored in the MNF for the flexible component to perform MSR on proloaded flexible bodies in Adams.
Note that this vector could represent a nonlinear stress state of the flexible component since the preload
could have taken on a nonlinear load path.
Similarly, recovering strain on a preloaded flexible body becomes:
{ }' = { 0 } + [ e ] { q }
where:
ch 2 u
ch u
where:
c is a constant independent of h and u.
u is the phenomenon being approximated (x for displacements or
for stresses)
The mesh parameter, h, can also be thought of as the inverse of n, the number of elements in the mesh
(1/n). In the limit, as h -> 0, the error also goes to zero. However, the convergence rate of error for
displacements is better than that for stress or strain. The dynamics of a flexible component depend on the
ability of its mesh to capture deformations or displacements. Therefore, a mesh suitable for dynamics
may not necessarily be suitable for stress recovery.
Therefore, you should consider mesh refinement if you are interested in recovering stress for the
component. In the case of MSR, this means that you must perform the mesh-refinement stage before the
initial modal analysis in the FE code. There is no assurance that the modal coordinates computed by
Adams for a given mesh density can be suitably applied to another mesh density of the same component
or geometry. In fact, the opposite has been observed and you should only combine modal coordinates
with modal stresses or strains from the same FE run that produced the mode shapes.
42 Adams/Durability
max
K t = ----------0
max
K t = ---------0
where Kt is used for normal stress and Kts is used for shear stress.
The nominal stress is usually calculated by the basic stress equations. Meanwhile, the maximum stress
(which depends on the geometry of the part or the type of irregularity considered) can be calculated by
numerical methods (finite-element analysis (FEA)) or by experimental tests.
The following figure shows the stress concentration factor (Kt) for the normal stress, plotted against the
geometric dimensions of the part. The main test case properties are shown in table below the figure.
Material
Steel
Young Modulus
(N/m2)
2.1E11
D (m)
5.0E-2
d (m)
3.85E-2
r (m)
2E-3
s (m)
1.0E-2
M (N m)
1
In this example, Kt= 2.225, so the maximum nominal stress can be analytically evaluated as:
M
M d
6M
61
n = ----- = ----- --- = -----------2- = ----------------------------------------2- = 4.0479E + 05N m
W
J 2
sd
0.01 3.85E 2
and the maximum normal stress due to the stress concentration is:
44 Adams/Durability
Both FE and MB models were loaded with the same conditions as in the analytical case. The modal
coordinateresulting from the MB analysis and the modal stress matrix were used to calculate the nodal
stresses.
The results of the comparisons between FEM and MB analysis are shown below:
Stress comparisons
(N/m2)
z xy
yz xz vonmises
1.4512E+05
0.0
0.0
8.8758E+05 2.1922
-0.00678E+05 0.0
0.0
4.0487E+05
1.4284E+05
0.0
0.0
8.7340E+05 2.1640
-0.00346E+05 0.0
0.0
4.0360E+05
Kt
46 Adams/Durability
70 Adams/Durability
Plotting Test Data
Comparing Data
To graphically compare data:
1. Clear the Surf check box.
2. Select Clear Plot to remove any curves in the plot area.
3. Set Source to either RPC III or DAC format files.
4. Select the file from the source list.
5. Make a selection in the File Data list, and then select Add Curves to display the curve.
6. Repeat Steps 3 through 5 to add more curves to the plot.
With DAC files, you may want to select multiple files because each file has only one result set.
You can use Shift+click or Ctrl+click multiple selection techniques.
4. Select OK in the File Import dialog box.
Adams/PostProcessor creates a DAC_FILE or RPC_FILE object below Root in the database after
you successfully import these files. Adams/PostProcessor only stores information about the
imported file from the file header. It does not store time history data in the database.
Adams/PostProcessor creates Result_Set_Component place holders below the file object for each
RPC III data channel or DAC file.
72 Adams/Durability
Using Test Data
3. Select OK.
Note:
If you enter the function incorrectly, you receive an error when you select OK. Check your
function syntax carefully.
Tip:
You can specify any expression of time in the first argument of the INTERP function. For
example, you can have a spline that references test track data with a 110-second duration,
but only simulate the last 30 seconds of this data. The INTERP function in this case would
be:
INTERP(time+80, 3, spline_name)
In addition, you would set the simulation time from 0 to 30 seconds.
3. Select OK.
If you enter the function incorrectly, you receive an error when you select OK. Check your
function syntax carefully.
74 Adams/Durability
Using Test Data
Creating a Spline
You use a spline to reference time history test data in RPC III Format or DAC Format. Each spline that
you define uses one independent variable (time) and one dependent variable (or channel) from the DAC
or RPC III file. By definition, DAC files only contain one channel of data, while RPC III files can contain
multiple channels identified by an integer channel number.
This procedure provides a brief overview on how to create splines for use with Adams/Durability. Learn
more about data element Splines.
To create a spline:
1. From the Build menu, point to Data Elements, point to Spline, and then select General.
The Data Element Create Spline dialog box appears.
2. In the Spline Name text box, enter the name you want to use for your spline.
3. Right-click the File Name text box, and select Browse.
The Select File dialog box appears.
4. Select the DAC or RPC III file.
Because these files can have any file extension, Adams/View opens the file and reads the file
header to determine the file type during the verification stage of the simulation. If the file type is
RPC III, you must enter a valid channel number in the Channel text box. If no channel or an
invalid number is specified for RPC III spline data, Adams/View reports an error and stops the
simulation.
5. In the Channel text box, enter the channel number you want this spline to use.
Note:
The range of valid numbers is from 1 to the number of channels in the file.
6. Select OK.
Adams/View creates a spline that references the physical test data from the channel in the file.
Note:
Adams/View ignores the Linear Extrapolate text box for splines that reference
76 Adams/Durability
Using Test Data
78 Adams/Durability
Adams/Durability Toolkit
Adams/Durability Toolkit
The Adams/Durability toolkit has three utilities for processing data or converting data from one format
to another. They are:
Durfilter - Filtering test data
MNF2FES - Creating FES files from MNF
RES2DUR - Processing Results files for Durability
To run the Adams/Durability toolkit from the program menu, enter adams2014 c durtk on Linux
systems or adams2014 durtk on Windows systems.
Description:
MNFname
-b
-e
A stress FES file can be used in an E-N or S-N fatigue analysis, while an
FES file containing strains can only be used in an EN analysis.
Argument:
-n nodefile
Description:
Specifies the file name with a list of nodes to process. Only those nodes listed in this
file will have their stress or strain stored in the FES and therefore, processed by FEFatigue.
Default: All nodes in the MNF will be processed.
-o FESfile
-u units
Specifies units of stresses to be stored in the FES (not needed with the -e option).
FES-supported units: MPA, PA, PSI, KSI, KGPA
Default: MPA
80 Adams/Durability
Filtering Test Data
Description:
inputfile
Specifies the name of the RPC III Format or DAC Format file to process, or the
prefix (job name) of a group of DAC files to process.
-b f1 f2
Specifies a band-pass filter. It takes two frequency values, f1 and f2, which are
specified in Hertz. Only frequencies between f1 and f2 are passed using this
filter option. Range: 0 < f1 < f2 <= Nyquist, where Nyquist is half the sampling
frequency of the data.
-c channels
Specifies the channels in an RPC III file to filter, or a group of DAC files to
filter. It takes one or more integer values separated by commas (,) or a colon
(:). These integer values represent specific channel IDs or a range of channel
IDs to process. This option is used in combination with the inputfile argument
to specify a set of DAC files to filter.
-d factor
Specifies the decimation factor to be applied to the test data. It takes one
integer value as the decimation factor. Decimation reduces the sampled rate of
the data by this factor. For example, a factor of 2 halves the number of data
points. A factor of 1 results in no change in the sample rate and this is the
default.
Range: factor > 0
-h freq
-l freq
-n order
Specifies the order of the filter to apply. It takes one integer value as the filter
order.
Default: order = 6. Range: order > 0.
Argument:
Description:
-o outputfile
Specifies the file name for storing the filtered and/or decimated data. A default
output file name composed of inputfile and the filtered/decimated
specification will be given if you do not specify this option.
-s f1 f2
Specifies a band-stop filter. It takes two frequency values, f1 and f2, which are
specified in Hertz. Only frequencies before f1 and beyond f2 are passed using
this filter option.
Range: 0 < f1 < f2 <= Nyquist, where Nyquist is half the sampling frequency
of the data.
Channel Selection
Typically, a group of DAC Format files acquired from one experiment or test are named with a common
prefix representing the job name and a two- or three-digit suffix representing the channel ID before the
extension (.dac). To apply the same filter to all or a set of DAC files from the same test, you specify the
prefix or job name only in the inputfile argument and the channel IDs or range of channel IDs using the
-c channels option. These arguments will then be used to compose the input file names for durfilter to
process as <inputfile><channel_ID>.dac where channel_ID is one of the channel IDs specified.
For RPC III data, only the channels specified in the -c option will be filtered and written out if they exist.
Data Decimation
Decimation or downsampling can be an effective way of saving disk space or reducing the amount of
data that Adams/Solver needs to interpolate if the given set of data has been oversampled. It can also
result in aliasing, however, a form of corruption in digital data. To ensure that aliasing does not occur, the
maximum frequency in the data should be less than half the decimated data sample rate.
Decimation is performed after filtering (if both are specified) to ensure more effective downsampling of
the test data.
Data Filtering
You can only specify one filter option in the durfilter argument list. The transfer function coefficient form
of the MATLAB Butter function is used in each filter option. Also, a forward and backward pass is
always performed to ensure no phase shift is introduced in the data.
For example, to perform a 6th-order high pass Butterworth filter with a cutoff frequency of 13 Hz and
zero-phase shift on data sampled at 200 Hz, the following MATLAB syntax (or its equivalent) is used:
[b,a] = butter(6, 13/100, high);
y = filtfilt(b, a, x);
where:
82 Adams/Durability
Filtering Test Data
b is the vector of numerator filter design coefficients and a is the vector of denominator
In the transfer function coefficient form of the Butterworth filter, numerical problems can arise for filter
orders as low as 15. Filter orders between 6 and 8 should be sufficient for most applications.
Examples
Here are three examples of how to use durfilter.
Example 1
Example 2
Example 3
Example 1
durfilter /disk/test/block.rpc b 1 60 n 8
All frequencies between 1 and 60 Hz are passed with an 8th-order filter on the data of each channel found
in the RPC III file /disk/test/block.rpc. Because no outputfile specification is provided, the filtered data
will be stored in file /disk/test/block_b8_1_60.rpc.
Example 2
durfilter rawdata c 7:12 l 120 d2 o filterdata
A 6th-order low-pass filter is performed on the input DAC files in column 1 of the table shown below.
The filtered data is decimated by a factor of 2 and stored in the DAC files in column two of this table.
Input filename:
Output filename:
rawdata07.dac
filterdata07.dac
rawdata08.dac
filterdata08.dac
rawdata09.dac
filterdata09.dac
rawdata10.dac
filterdata10.dac
rawdata11.dac
filterdata11.dac
rawdata12.dac
filterdata12.dac
Example 3
durfilter beltest_ c 101,102,103,201,202,203 h 10 n 8
An eighth-order high-pass filter is performed on the input DAC files in column one of the table shown
below. Because no outputfile specification is provided, the filtered data is stored in DAC files with names
composed of the given filter specifications as shown in column two of this table.
Input filename:
Output filename:
beltest_101.dac
beltest_h8_10_101.dac
beltest_102.dac
beltest_h8_10_102.dac
beltest_103.dac
beltest_h8_10_103.dac
beltest_201.dac
beltest_h8_10_201.dac
beltest_202.dac
beltest_h8_10_202.dac
beltest_203.dac
beltest_h8_10_203.dac
84 Adams/Durability
Filtering Test Data
A two-pass filter operation is performed to ensure zero-phase shift of the test data. Decimation of the test
data is also available in durfilter.
Format
Following is the format of the filtering command using durfilter:
durfilter
[ -b
[ -c
[ -d
[ -n
[ -o
inputfile
f1 f2 | -h freq | -l freq | -s f1 f2 ]
channels ]
factor ]
order ]
outputfile ]
Description:
Argument:
Description:
modelfile
resultsfile
Note:
The model file provides the output specifications for the FEMDATA and
REQUEST statements, as well as the OUTPUT options. The results file name
86 Adams/Durability
Examples 87
Examples
88 Adams/Durability
2 Adams/Durability
Generates files you can use as input to a Modal Stress Recovery (MSR) analysis in ANSYS. A
customized version of ANSYS (ANSCUST) containing macros must be built to perform this MSR
analysis in ANSYS. The MSR macros and source code are found in the Adams release directory
install_dir/durability/ANSYS (where install_dir is the directory where Adams/Durability is installed).
Consult your ANSYS documentation for more information on building an ANSCUST executable.
Learn more about Exporting Data for ANSYS.
For the option:
Do the following:
Output File
(Export Option)
Specify the starting and ending time of the analysis you want to export. If you
do not specify a range, Adams/Durability exports the entire analysis.
Basis
Format
Include Modal
Velocities
Do the following:
the Node List File text box where you can specify the name of the
file that contains a list of specific nodes.
From List: Exports a partial set based on individual nodes. If
this checkbox and then specify the name of the file to which you
want the information saved.
4 Adams/Durability
Compute Nodal Plot
Calculates nodal stress or strain values. These values can be used to generate X-Y plot displays of nodal
stress or strain time histories.
Learn more about Computing Stresses or Strains.
For the option:
Do the following:
Flexible Body
Type Options
Value
Reference Marker
Exports modal coordinates for subsequent FE-Fatigue damage analysis or FE modal superposition. You
can generate a partial FES file (nCode FE-Fatigue file format) suitable for Fatigue Life Prediction (FLP)
analysis when stress or strain blocks are present in the MNF.
Learn more about Exporting for nCode.
For the option:
Do the following:
Job Name
Enter the name of the job you want to create. All files created in this
procedure will have this entry as the prefix.
Modal Coordinates
Specify the starting and ending time of the analysis you want to export. If
you do not specify a range, Adams/Durability exports the entire analysis.
Basis
Format
FES File
6 Adams/Durability
Do the following:
Specify the format of the file you want to export:
ASCII: ASCII FES files can be easily viewed and edited, and are
platforms.
Note:
Stress/Strain
Select Nodes
displays the Node List File text box where you can specify the
name of the file that contains a list of specific nodes.
From List: Exports a partial set based on individual nodes. If
select this checkbox and then specify the name of the file to
which you want the information saved.
Imports MSC.Fatigue results for a flexible body into Adams. Results from an MSC.Fatigue analysis are
stored in a file called jobname.fef. Once imported, Adams/Durability can process these results and
postprocess them in Adams/PostProcessor. You can use the LIFE function to search the MSC.Fatigue
results and return the minimum life of the flexible body.
Fatigue Result
For the option:
Do the following:
Enter the name of the fatigue results file (.fef) that you want to import.
Flexible Body
Enter the name of the flexible body to which you want the results associated.
Analysis
Enter the name of a previously run analysis to which you want the fatigue results
associated. This text box is optional. If the analysis is not specified, the fatigue
results will be associated only with the flexible body and the results will be
available for all analyses.
This is useful for a duty-cycle fatigue analysis where more than one Adams
analysis set was used.
Note:
Once you have successfully imported MSC.Fatigue results (by completing this dialog
box), Adams/Durability adds additional options in the Plot Type menu of the Contours tab
(in Adams/PostProcessor). This allows you to specify the fatigue result to contour.
8 Adams/Durability
Imports your FE-Fatigue results. Once you've imported a universal file from FE-Fatigue,
Adams/Durability adds more Plot Type options (under Contours) to the Adams/PostProcessor. These
options are used for postprocessing nCode results.
For the option:
Do the following:
Enter the name of the results (.unv) file you want to import.
Flexible Body
Enter the name of the flexible body to which you want to associate the results.
Analysis
Optionally, enter the name of a previously run analysis to which you want the FEFatigue results associated. If you don't specify an analysis, Adams/Durability
associates the FE-Fatigue results to the flexible body, and makes it available for
the postprocessing of any Adams run.
Note:
Once you have successfully imported FE-Fatigue results (by completing this dialog box),
Adams/Durability adds additional options in the Plot Type menu of the Contours tab (in
Adams/PostProcessor). This allows you to specify the fatigue result to contour.
FE Part Output
Durability -> FE Part Output
Allows you to specify the stress/strain channels on a FE Part that you want to plot. These values can be
used to generate X-Y plots of FE_Part stress or strain time histories.
The stress/strain can be computed either at one or more nodes on a FE_PART or one or more markers.
Once the Analysis, FE Part, Location and Marker/Node information is specified along with the
Stress/Strain option and type, Adams/Durability stores the stress or strain components in a FE_PART
result set for the specified analysis. It adds the following field to the Adams/View database for the FE
Part being analyzed:
FE_Part_name_STRESS.NodeName_Value
FE_Part_name_STRAIN.NodeName_Value
Where:
FE_Part_name is the name of your FE Part
NodeName is the FE Part node name whose stress or strain you are calculating
_Value is the value of stress or strain you're calculating
Do the following:
FE Part
Location
Either Marker or Node can be selected from this option menu. That is, the stress
or strain values can be generated either at the selected nodes of the FE Part centreline or at specified markers.
Marker Name
This option is available only when Marker is selected in the Location option menu
above. You can enter one or more markers here.
Node Name
This option is available only when Node is selected in the Location option menu
above. You can enter one or more nodes on FE Parts here.
Type Options
Value
10 Adams/Durability
Provides a convenient method of generating a hot spot report on a body. It uses the HOT_SPOTS or
TOP_SPOTS user function depending on the option selected.
Learn more about Visualizing Hot Spots.
For the option:
Do the following:
Analysis
Type
Specify the value to be computed at each hot spot, and then select stress (for bodies
with a rigid stress object) or strain.
Radius
Enter the distance between hot spots. All nodes that fall within this radius are
candidates for the same hot spot. A value of 0.0 considers all nodes to be potential
hot spots.
Threshold/Count
Sort Order
would use this option when only the magnitude is important, not the sign
or direction (in the case of stress or strain).
Maximum - Hot spots are ranked from maximum to minimum.
Minimum - Hot spots are ranked from minimum to maximum.
File Format
by tab characters. This format is convenient for importing the data into a
spreadsheet program.
Do the following:
File Name
Optionally, enter the name of the file to which you want to save the information.
If no extension is given for the name, a default extension is used depending on the
File Format setting (.txt for tab-delimited text and .htm for HTML). Both file
formats can be displayed in Adams/PostProcessor (from the File menu, point to
Import, and then select Report).
Start
Optionally, enter the time in the analysis to begin checking for hot spots. The
default is the beginning of the analysis.
End
Optionally, enter the time in the analysis to stop checking for hot spots. The default
is the end of the analysis.
Enter the font size of the information that is displayed in the report section of the
dialog box. You can change the font size before or after the data is displayed.
Report
12 Adams/Durability
INTERP
INTERP
The INTERP function returns the iord derivative of the interpolated value of SPLINE/id at time=x. The
INTERP function supports time-series splines, which are splines that include a FILE argument that
specifies a time history file of type DAC or RPC III.
Format
INTERP (x, method, id [,iord])
Arguments
id
An integer variable that specifies the identifier of a SPLINE statement that you define in
the Adams/Solver dataset. The SPLINE id must reference time series data from a DAC
or RPC III file.
iord
An integer variable specifying the order of the derivative that Adams/Solver takes at the
interpolated point, and then returns through
INTERP.
Default: 0 (take no derivative)
Range: 0 < iord < 2
method
An integer variable that specifies the method of interpolation, either linear or cubic
interpolation.
Range: method = 1 (linear interpolation)
method = 3 (cubic interpolation)
A real variable that specifies the value of time, the independent variable along the x-axis
of the time series spline that is being interpolated.
Extended Definition
The INTERP function uses linear or cubic interpolation to create a function across a set of data points.
The data points are defined in a SPLINE statement in the Adams/Solver data deck. The SPLINE
statement with the FILE argument that you define in the Adams/Solver dataset must reference a time
series file of type DAC or RPC III. For more information on these file types, see Introduction to
Adams/Durability.
In general, the INTERP function with linear interpolation will not be a smooth function because, in
almost all cases, the function will be discontinuous in the first derivative. Therefore, the estimate of the
first derivative may be erroneous even though, by definition, the data points of a DAC or RPC time
history file are evenly spaced. In all cases, the second derivative of the function being approximated is
unreliable with linear interpolation.
On the other hand, with cubic interpolation, the INTERP function will be continuous to the second
derivative. Therefore, we recommend that you use cubic interpolation, especially if first or second
derivatives of the function will be evaluated.
Examples
SPLINE/101
,FILE=test_data.rsp
,CHANNEL=9
SFORCE/1, I=409, J=109, TRANSLATION
,FUNCTION=INTERP(TIME,3,101)
The SFORCE statement defines a translational force that acts between Markers 409 and 109. The
SPLINE statement specifies that the discrete data used to interpolate the value of the SFORCE comes
from CHANNEL 9 of the RPC III file test_data.rsp.
The INTERP function references this spline, defines the independent variable to be simply, TIME, and
selects cubic as the method of interpolation.
14 Adams/Durability
Exports Adams results as DAC time history files and/or launches MSC.Fatigue. Currently, only the
modal coordinates of flexible bodies are supported. You can combine these modal coordinate time
histories in MSC.Fatigue with the modal stresses from MSC.Nastran to compute stress time histories, and
ultimately, the life or damage of the flexible body.
Learn more about Exporting Data for MSC.Fatigue.
For the option:
Do the following:
Job Name
Enter the name of the job you want to create. All DAC files will be
named with this prefix.
Modal Coordinates
If you select Modal Coordinates, Adams/Durability displays the following text boxes:
Analysis
Specify the starting and ending time of the portion of the analysis you
want to export. If you do not specify a range, Adams/Durability exports
the entire analysis.
Run MSC.Fatigue
If you select Run MSC.Fatigue, Adams/Durability displays the following text boxes:
Run Command
Enter the name of the MSC.Patran database you want to create or open.
Do the following:
Nastran BDF
Specify the file that contains the MSC.Nastran Bulk Data File that was
used to generate the Modal Neutral File (MNF) of the flexible body.
Nastran OP2
Specify the MSC.Nastran OP2 file that contains the modal stress or
strain data for the flexible body. This should be the .out file that was
used to generate the MNF of the flexible body or created in the same
run as the MNF using the ADMOUT option on the Nastran
AdamsMNF command.
16 Adams/Durability
Creates an .mdf file that can be referenced in a NASTRAN DMAP to recover dynamic stresses of the
flexible component in NASTRAN.
Learn about Exporting Data for NASTRAN.
For the option:
Do the following:
Output File
File Format
(Export Option)
Specify the starting and ending time of the analysis you want to export. If
you do not specify a range, Adams/Durability exports the entire analysis.
Skip
Do the following:
Remove 1G deformation Select if you want to subtract static deformation from the transient results.
If selected, Adams/Durability removes the static component from the
dynamic stresses recovered in Nastran.
Include Modal Velocities Select to include modal velocities along with modal deformations in the
.MDF file. If not selected, only the modal deformations are included in the
.MDF file.
18 Adams/Durability
Appendix
2 Adams/Durability
Appendix 3
Element Order
Element Order
When specifying the element order in the Create Rigid Stress dialog box, enter one of the following:
Linear - Sets linear element order for first-order elements.
Parabolic - Sets parabolic for second-order elements.
The following table identifies the effects of selecting different element types and orders:
Element
order:
Number
of nodes:
DOF per
node:
Linear
Limitations:
Element examples:
Parabolic
Tip:
10
We recommend parabolic elements for stress recovery. Linear versions of these elements
are able to predict only a constant stress state in their element domain, therefore, requiring
much finer meshes than their parabolic counterparts.
4 Adams/Durability
Appendix 5
Entering Object Names in Text Boxes
6 Adams/Durability
FES-Supported Units
FES-Supported Units
If the current unit settings of force and length do not match one of the rows in the table, a warning will
be issued and stresses will be written out to the FES file in the default units of MPa.
Force
Length
Stress
Newton
millimeter
Mpa
Newton
meter
Pascal
Pound
inch
PSI
Kilopound
inch
KSI
Kilogram
meter
kg/m2
Appendix 7
MSC.NASTRAN Input Deck
8 Adams/Durability
Appendix 9
Which Basis Option Should I Use?
If you select to export to an FES file later in this procedure, the Basis text ox will
automatically change to Orthonormalized.
10 Adams/Durability
A
Adams/Durability
benefits of using 2
Adams/PostProcessor
comparing data 2
displaying stress/strain contours 8
importing test data 2
plotting data 2
plotting stresses/strains 8
ADMFORM parameter 4
Analysis
stress recovery 3
ANSYS
export dialog box 2
exporting for 3
Applying test data 4
Arguments for durfilter 4
B
Browsing data 5
Butterworth filter 5
C
Channel selection 5
CHECK parameter 4
Component mode synthesis 8
Computing stresses/strains
dialog box 4
procedure 7
Coordinate reference transformation 2
Creating a spline 6
Curve Edit toolbar 7
D
DAC format
exporting 7
overview 7
Data decimation 5
Data filtering 5
Demand-loaded library 2
Displaying stress/strain contours 8
Durfilter
2 Adams/Durability
about 7
arguments 4
channel selection 5
data decimation 5
data filtering 5
examples 6
format 8
naming conventions 6
E
Examples
durifilter 6
stress calculation 8
Exporting
ANSYS dialog box 2
ANSYS overview 3
MSC.Fatigue dialog box 13
MSC.Fatigue overview 4
NASTRAN dialog box 15
NASTRAN overview 5
nCode (FE-Fatigue) dialog box 5
nCode (FE-Fatigue) overview 6
RPC III or DAC 7
F
FE-Fatigue
export 5
FE-Fatigue
FE-Fatigue Import Universal Results File dialog box 7
MSC.Fatigue Import Results File dialog box 7
FEMDATA statement 7
in exporting 5
setting up 3
FES file
MNF2FES tool 2
nCode 6
Filtering test data
naming conventions 6
options
Data Filtering 5
Filtering Test Data 7
overview 7
Force
defining 2
H
Hot spots
HOT_SPOTS user function 3
information dialog box 9
I
Importing
FE-Fatigue results
FE-Fatigue Import Universal Results File dialog box 8
MSC.Fatigue Import Results File dialog box 7
test data 2
INTERP function
in motion 2
INTERP assist dialog box 11
using 4
L
Library
demand-loaded 2
LIFE user function 5
Load association file 6
Loading Adams/Durability plugin 3
M
MAX_STRESS user function 6
MNF2FES tool 2
Modal deformations file
reading 3
Model export
ANSYS 2
NASTRAN 15
Motion
defining 2
MSC.Fatigue
export 13
exporting for
Exporting Data for MSC.Fatigue 4
MSC.Fatigue Export dialog box 13
MSRMODE parameter 4
4 Adams/Durability
N
NASTRAN
exporting for 15
OP2 files 4
stress recovery 5
nCode
exporting for
Exporting Data for nCode 6
FE-Fatigue Export Dialog Box 5
Nodal stress components
dialog box 4
O
OUTPUT statement
about 3
in exporting 5
OUTPUT2 5
Outputting
FEM Data 3
requests 3
P
Parameters
ADMFORM 4
CHECK 4
MSRMODE 4
POST 4
RGBODY 4
Plotting
data 2
overview 2
stresses/strains 8
Plugin manager 3
POST parameter 4
Post-processing 3
R
Reading modal deformations file (MDF) 3
Referencing test data 7
Requests
REQUEST statement 3
setting up 8
RES2DUR tool 9
Results
importing
FE-Fatigue Import Universal Results File Dialog Box 8
MSC.Fatigue Import Results File Dialog Box 7
post-processing 3
processing with RES2DUR 9
RGBODY parameter 4
RPC III format
exporting 7
overview 7
S
Setting up requests 8
Simulating 9
Spline
about 4
creating 6
Starting Adams/Durability 3
Statements
FEMDATA 3
OUTPUT
setting up 3
REQUEST 3
Stress calculation example 8
Stress concentration evaluation 8
Stress recovery
analysis 3
background 8
NASTRAN 5
Type 1 5
Type 2 5
Stresses
computing overview (flexible bodies) 7
Stresses/strains
computing 7
displaying contours 8
plotting 8
Stressses
recovering on rigid bodies 10
6 Adams/Durability
T
Test data
applying 4
filtering 7
filtering options 7
referencing 7
TOP_SPOTS user function 7
transformation
coordinate reference 2
Type 1 stress recovery 5
Type 2 stress recovery 5
U
Unloading the Adams/Durability plugin 3
User functions
HOT_SPOTS 3
LIFE 5
MAX_STRESS 6
TOP_SPOTS 7
V
Validating model 9
W
What-if simulations 9