Professional Documents
Culture Documents
2015 SAS IP, Inc. All rights reserved. Unauthorized use, distribution or duplication is prohibited.
ANSYS, ANSYS Workbench, Ansoft, AUTODYN, EKM, Engineering Knowledge Manager, CFX, FLUENT, HFSS, AIM
and any and all ANSYS, Inc. brand, product, service and feature names, logos and slogans are registered trademarks
or trademarks of ANSYS, Inc. or its subsidiaries in the United States or other countries. ICEM CFD is a trademark
used by ANSYS, Inc. under license. CFX is a trademark of Sony Corporation in Japan. All other brand, product,
service and feature names or trademarks are the property of their respective owners.
Disclaimer Notice
THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.
For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).
Third-Party Software
See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, Contact ANSYS, Inc.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
FATJACK User's Manual
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
FATJACK User's Manual
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
vi of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: FATJACK Introduction
FATJACK (FATigue calculations for offshore JACKets) is the fatigue calculation module. FATJACK is used
for the estimation of fatigue life for tubular and beam joints, employing deterministic or spectral
methods.
FATJACK represents a complete revamp of the philosophy as to how joint fatigue calculations are un-
dertaken, and embodies many new features that assist the designer in attaining optimal results with
the minimum of supplied data. The following facilities are provided by FATJACK.
Design override capabilities to allow user defined joint configuration, member properties and secondary
members
SCF values for a brace may be computed automatically using Kuang, Wordsworth, DS449 or Efthymiou for-
mulations
SCF values for a given brace may be computed from more than one empirical equation set allowing the
most appropriate equations to be adopted for specific inspection points around the brace
Computed SCFs may be output to a formatted file for modification and utilization in subsequent FATJACK
runs
S-N data may be input using standard pre-defined curves. User defined curves may now define a cut-off
value
Completely revised input data syntax allowing greater flexibility in data preparation
A brief overview of the analysis methods (p. 35) available is provided. For more detailed information
see Ref. 1 (p. 127).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: FATJACK Theory
This section discusses the following topics:
2.1. Fatigue Assessment
2.2. S-N Curves
2.3. Miner's Rule
2.4. Deterministic Methods
2.5. Spectral Analysis
2.6.Time History Methods
2.7. Strategies for Wave Fatigue Analysis
2.8. Parametric SCF Equations
N = AS-m
In air, or where corrosion prevention is undertaken, an endurance limit can be identified for constant
amplitude stress cycling below which no fatigue occurs. For variable amplitude stress cycling the cut-
off stress decreases as the fatigue crack grows and this is often allowed for by changing the slope of
the S-N curve below a certain stress level.
Values of A and m are available for a range of typical joints. Values of A and m are available for a range
of typical joints. Many codes of practice provide one or more standard S-N curves, some of which have
been embodied within the FATJACK software.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
FATJACK Theory
Where many wave cases are being analyzed, the fatigue damage for one wave case with a stress range
Si and a number of cycles ni is:
Since the calculation is based upon the number of cycles in a year for the constituent waves, the resulting
damage is that associated with one year of operation. The fatigue life (in years) is, therefore, the recip-
rocal of the damage; that is:
life = 1/D
Fatjack also calculates a usage figure, for easy comparison of results. This factor is based upon:
Usage = (DT)(1/S)
where:
The environmental loading is idealized by representative wave cases, each with a defined number of
loading cycles (or occurrences) in a year. The wave loading is generated (normally using Mechanical
APDL) to produce a series of loadcases which represent the waves for the required number of wave
heights, periods and directions. The structure is then analyzed to determine the stress S for each of the
loadcases and, hence, the fatigue life using Miners Rule.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
Spectral Analysis
Under normal circumstances, where the structure responds sinusoidally to the load, the wave loading
generates a loadcase pair for each wave case analyzed. This pair of loadcases represents the real and
imaginary parts of a solution which retains both magnitude and phase information. This is achieved by
undertaking a harmonic wave analysis within Mechanical APDL. This approach is an efficient and effective
way of determining the stress response of the structure to steady state harmonic loading. FATJACK uses
this data to generate the stress ranges directly from the incoming member forces for the loadcase pairs.
This methodology is selected using the ANALYSIS DETERMINISTIC (p. 55) command.
In situations where the structure stress response becomes nonlinear (for example, in shallow water), a
sinusoidal representation may become invalid in which case a more detailed analysis needs to be adopted.
The stress history approach utilizes the stresses resulting from discrete positions for a given wave to
determine explicitly the stress range. In this case Mechanical APDL is used to generate one or more
loadcases for each wave case to adequately define the response of the structure to the applied loading.
If only one loadcase is provided it is assumed to represent the stress amplitude. In this case the stress
range is computed as twice the amplitude. For any other number of loadcases the stress range is
computed as the difference between the maximum and minimum stress occurring within each of the
constituent loadcases forming the wave.
This methodology is selected using the ANALYSIS STRESS HISTORY (p. 55) command.
For the purpose of sea state identification, wave direction is usually classified into eight sectors of 45
incidence angle bands (Figure 2.1: Sea states are applied by direction sector scatter diagrams (p. 6)).
In each sector, the occurrence rate of each random sea state, characterized by significant wave height,
Hs, and mean zero crossing period, Tz, is identified as a number on a scatter diagram (Figure 2.2: A
scatter diagram summarizing the relative occurrence rate of individual sea state conditions for one
direction (p. 6)). The ratio of this number of occurrences to the total for all eight sector scatter diagrams
gives the weighting to be applied later in determining the amount of fatigue damage due to each sea
state.
In a particular random sea state, the instantaneous water surface elevation is considered to be caused
by the combined effect of an infinite number of steady state components of wave frequency having
random phase relationships. The amplitude content versus frequency has been shown by practical in-
vestigation to be related to the significant wave height and mean zero crossing period. Using relationships
such as the JONSWAP (Ref. 6 (p. 127)), Scott-Weigel, Pierson-Moskowitz (Ref. 5 (p. 127)) or Ochi-Hubble
(Ref. 7 (p. 127)) spectra, each scatter diagram sea state can be reconstituted in terms of water surface
elevation components throughout the frequency range producing sea state spectra, S (See diagram
(a) in Figure 2.3: Random Sea States (p. 6)).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
FATJACK Theory
Figure 2.1: Sea states are applied by direction sector scatter diagrams
Figure 2.2: A scatter diagram summarizing the relative occurrence rate of individual sea state
conditions for one direction
For a given inspection point on the structure, a stress transfer function, f, is developed by computing
the normalized stress range for each of the constituent waves within a wave incidence sector, the
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
Strategies for Wave Fatigue Analysis
stresses being normalized by the associated wave heights (See diagram (b) in Figure 2.3: Random Sea
States (p. 6)).
The stress response spectrum for a given sea state, S, can then be determined by multiplying the
wave spectrum by the square of the associated stress transfer function (See diagram (c) in Figure 2.3: Ran-
dom Sea States (p. 6)).
Thus
S = S*2f
The fatigue damage incurred from one sea state at one stress inspection point is evaluated using
parameters from its stress response spectrum, the material fatigue data, Miners Rule and the relative
rate of occurrence of that sea state, including the assumption that the peak stress levels are distributed
according to a Rayleigh probability distribution (See diagram (d) in Figure 2.3: Random Sea States (p. 6)).
The damage in one year from each sea state for each inspection point is given by:
The annual damage from each of the sea states is then summed in order to give the total annual
damage from all sea states. The fatigue life is the reciprocal of the total annual damage.
For single slope S-N curves, the damage calculation is undertaken using a gamma function solution
which provides an efficient method for carrying out the integration expression. For multi-linear S-N
curves no such closed form solution exists and the integration has to be undertaken by numerical in-
tegration techniques.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
FATJACK Theory
The processes involved for various types of fatigue study when using the ANSYS Asas solver are sum-
marized in Figure 2.4: Strategies for wave fatigue analysis using ANSYS Asas (p. 9).
Figure 2.5: Example of a time stress history fatigue analysis using ANSYS Asas (p. 10), Figure 2.6: Example
of a harmonic deterministic fatigue analysis (static) using ANSYS Asas (p. 11), and Figure 2.7: Example
of steady state dynamic spectral fatigue analysis using ANSYS Asas (p. 12) provide an overview of the
control data required to undertake the different fatigue analyses that are available in FATJACK. Fig-
ure 2.8: Example of a time history fatigue analysis using ANSYS Asas (p. 13) shows the control data re-
quired to undertake a time history fatigue analysis following a series of transient dynamic analyses.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
Strategies for Wave Fatigue Analysis
Figure 2.4: Strategies for wave fatigue analysis using ANSYS Asas
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
FATJACK Theory
Figure 2.5: Example of a time stress history fatigue analysis using ANSYS Asas
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
Strategies for Wave Fatigue Analysis
Figure 2.6: Example of a harmonic deterministic fatigue analysis (static) using ANSYS Asas
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
FATJACK Theory
Figure 2.7: Example of steady state dynamic spectral fatigue analysis using ANSYS Asas
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
Figure 2.8: Example of a time history fatigue analysis using ANSYS Asas
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
FATJACK Theory
Key:
= d/D
= D/(2T)
= t/T
= L/R
= g/D
T = chord thickness
t = brace thickness
L = chord length
Validity Range
The following Wordsworth equations are generally valid for joint
parameters within the following limits:
12 <= <= 32
30 <= <= 90
8 <= <= 40
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
WT2
In-plane
bending WT3
Out-of-plane
bending WT4
Brace side
SCFs
WX2
In-plane
bending WX3
Out-of-plane
bending WX4
(balanced)
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
FATJACK Theory
WK1
WK2
WK3
In-plane
bending
WK4
Out-of-plane
bending
(unbalanced)
WK5
Brace side
SCF's
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
Unbalanced
out-of-plane
bending
WKT2
WKT3
The above equations were derived with equal sized braces. Caution
should therefore be used when applying the equations to nodes where
there is a large variation in brace dimensions.
Brace load
SCFs
Validity Range
The following Kuang equations for T/Y, K and KT joints are
generally valid for joint parameters within the following limits:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
FATJACK Theory
KT2
In-plane KT3
bending
KT4
Out-of-plane KT5
bending KT6
KT7
KT8
KK2
In-plane
bending KK3
KK4
Out-of-plane
bending KK5
KK6
KK7
KK8
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
KKT2
KKT3
KKT4
In-plane
bending
KKT5
KKT6
Out-of-plane
bending
KKT7
KKT8
KKT9
KKT10
DT1
DT2
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
FATJACK Theory
DT4
Out-of-plane
bending
DT5
DT6
Validity Range
The following Danish equations for Y, K and KT joints are
generally valid for joint parameters within the following limits:
8 <= <= 33
0 <= <= 90
7 <= <= 40
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
Axial load
DY1
DY2
In-plane
bending
DY3
DY4
Out-of-plane
bending DY5
DY6
DY7
DY8
Axial load
K-joints
DK1
DK2
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
FATJACK Theory
DKT2
DKT3
In-plane
bending
DK3
DK4
Out-of-plane
bending
Validity Range
The following Danish equations for X joints are generally valid
for joint parameters within the following limits:
12 <= <= 32
30 <= <= 90
8 <= <= 40
DX1
DX2
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
DX4
Out-of-plane
bending
DX5
DX6
Validity Range
The following Efthymiou equations for T/Y joints are generally
valid for joint parameters within the following limits:
8 <= <= 32
20 <= <= 90
4 <= <= 40
ET7 None
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
FATJACK Theory
ET9 None
Out-of-plane
bending ET10 F3
ET11 F3
EX2 None
EX4 None
In-plane
bending None
None
Out-of-plane
bending EX5 F3
EX6 F3
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
EK2 None
Unbalanced
in-plane
bending
EK3
Unbalanced
out-of-plane
bending EK4 F4
EK5 F4
[ET10]A is the chord SCF adjacent to brace A as estimated from eqn ET10.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
FATJACK Theory
Note that the designation of braces A and B is not geometry-dependent, it is nominated by the user.
In-plane
bending
Out-of-plane
bending
EKT1 F4
EKT2 F4
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
Table 2.16: Efthymiou Equations For SCFs In X-joints For Use In Influence Function Calculations
Out-of-plane
bending on F3
reference
brace only F3
EIX1
EIX2
EIX3
EIX4
Out-of-plane
bending
EIX5
EIX6
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
FATJACK Theory
Note that in the above expressions subscript A refers to the reference brace, subscript B to the interacting
brace under consideration.
Table 2.18: Efthymiou Equations For SCFs In Gap/Overlap K-joints For Use In Influence Function
Calculations
None
Out-of-plane
bending on
one brace EK6 F3
only
EK7 F3
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
Note that in the above expressions subscript A refers to the reference brace, subscript B to the interacting
brace under consideration.
EIK1
EIK2
EIK3
EIK4
Out-of-plane
bending
EIK5
EIK6
EIK1
EIK2
EIK3
EIK4
Out-of-plane
bending
EIK5
EIK6
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
FATJACK Theory
Note that in the above expressions subscript A refers to the reference brace, subscript B to the interacting
brace under consideration.
Table 2.20: Efthymiou Equations For SCFs in KT-joints For Use In Influence Function Calculations
Out-of-plane
bending on
reference EKT3
brace only
EKT4
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
EKT4
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
FATJACK Theory
EIKT1
EIKT2
EIKT3
EIKT4
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
Parametric SCF Equations
EIKT6
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: FATJACK Analysis Methods
This section discusses the following topics:
3.1. Overview
3.2. Environmental Information
3.3. Joint Selection
3.4. Joint Classification
3.5. Inspection Points
3.6. Design Information
3.7. Stress Concentration Factors
3.8. S-N Curves
3.9. Units
3.10. Element Cross Sections
3.11. Results presentation
3.1. Overview
Fatigue analyses can require large amounts of data due to the methods employed in determining the
hot spot stresses from the nominal brace loads. In addition, the mathematical model is often greatly
simplified especially at joints where brace center-lines are assumed to pass through a common point
and where stub and/or can details have been omitted.
FATJACK includes an extensive command set which enables the user to automatically generate much
of the required data and provides methods for developing a more precise definition of the problem
than can be obtained from the analysis model.
Provided that the environmental wave loading has been generated using the ocean definition in
Mechanical APDL, FATJACK can automatically extract the wave information from the analysis database
files. It should be noted, however, that this facility is not available if the loading has been modified in
any way. In these cases the wave information must be supplied as part of the FATJACK input data.
The joints may either be listed explicitly or using the keyword ALL to request that every joint which
has valid elements connected is to be processed. Only BEAM and TUBE elements will be used by FATJACK,
all other element types will be ignored.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
FATJACK Analysis Methods
Joints are usually represented by a single node, to which the brace and chord elements are attached.
It is sometimes necessary to model the physical separation of work points in a joint by the use of 2 or
3 nodes.
This is achieved using a combination of CHORD (p. 73) and TYPE (p. 119) commands. In these cases one
of the nodes is designated as the joint node and this is used when referring to any properties regarding
that joint.
Unless otherwise defined (by using the CHORD (p. 73) command) the chord at a given joint is selected
based upon the connecting members with the largest diameter. Where several members have the same
diameter, the elements with the largest thickness are adopted. In certain circumstances this process
will not produce a unique chord definition; for example, at X joints with similar members, in which case
the chord specification is compulsory. It should also be noted that where the chord elements are de-
termined by the program the chord length required for the stress concentration factor (SCF) calculations
will be computed as 2/3 times the combined lengths of the selected elements. This will produce erro-
neous SCFs if the chord elements selected do not completely define the chord member; for example,
where intermediate nodes have been included. Either all the elements which constitute the chord should
be defined, or an explicit chord length should be given, using the CHORD (p. 73) command.
The remaining members at a joint, considered to be brace members, are then separated into groups
of elements that are in the same chord-brace plane. Within each plane a joint configuration is identified
for each brace end using the following classification table:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.
Inspection Points
Notes
1. Nnear is the number of braces on the same side of the chord as the brace under consideration (including
the brace under consideration).
2. Nfar is the number of braces on the far side of the chord with respect to the brace under consideration.
3. If the angle subtended with the chord is 90o5o then the reference brace is designated as a T, otherwise
the joint is classified as a Y.
If the user wishes to assign joint classifications other than that provided by the program this can be
achieved by using TYPE (p. 119) commands for the joint/brace combinations concerned. Note that
TYPE (p. 119) commands are ignored if using influence functions since this relies on a knowledge of all
braces at a joint.
The member local reference x axis is defined as being along the member concerned and is always ori-
entated away from the joint. The local reference y axis is in the same direction as the member local
reference y axis. The local reference z axis forms a right handed set with the member axis and the local
reference y axis. Note that, for consistency, the results are reported in terms of brace in-plane (y local
axis) and out-of-plane (z local axis) bending.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 37
FATJACK Analysis Methods
The member local reference x axis is defined as being along the member concerned and is always ori-
entated away from the joint. The local reference y axis is in the same direction as the member local
reference y axis. The local reference z axis forms a right handed set with the member axis and the local
reference y axis. Note that, for consistency, the results are reported in terms of brace in-plane (y local
axis) and out-of-plane (z local axis) bending.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
38 of ANSYS, Inc. and its subsidiaries and affiliates.
Stress Concentration Factors
The member local reference x axis is defined as being along the brace concerned and is always orientated
away from the joint. The in-plane axis is in the same direction as the brace local y axis. The out-of-plane
axis forms a right handed set with the brace axis and the in-plane axis.
There may be many instances when the data utilized for the structural analysis is inconsistent with that
required to undertake the fatigue study and FATJACK provides several mechanisms to override the
values that would be adopted by default.
The stress concentration factors (SCFs) may be provided in one or two ways:
Utilizing built-in empirical formulations to automatically generate the required SCF values.
An alternative approach to conventional SCF evaluation of hot spot stresses is the use of so-called in-
fluence functions which account for the load distribution at a joint. This method can be requested when
using the Efthymiou equations by including the INFL option.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
FATJACK Analysis Methods
SCFJ if crown and saddle SCF values are known; for example, if generated by empirical formulae
by the user.
SCFA if SCF values are known at specific locations; for example, results of a detailed finite element
joint analysis, or from model tests.
For all section types a default value may be defined which is associated with a brace element in the
absence of any explicit definitions or computed SCF values. Note that default SCF values are associated
with a section profile (WF, BOX, etc) rather than an element type (BEAM, TUBE).
These formulations provide SCF values which depend upon the joint classification, load condition, and
position around the brace/chord interface.
This facility enables brace elements at a joint to have SCF values computed at the crown and saddle
locations. To provide increased flexibility in the application of empirical formulae to SCF calculations,
FATJACK includes the ability to utilize different formulations for specific SCF values around a given
brace member. This is achieved by specifying an equation matrix, the constituents of which define the
formula to be adopted for each of the loading components and position. The user can thus utilize the
most appropriate formulations for a given joint type as required by many certification authorities.
Automatic generation of SCF values is requested using the SCF AUTO (p. 98) commands. To provide
total flexibility in the determination of the SCF values, parameter definitions and limits may be modified
using the PARAMETER (p. 94) and LIMIT (p. 91) commands.
The brace side SCF values obtained from the Kuang equations may be modified using the Marshall
Reduction factor if required using the REDUCTION (p. 97) command.
In addition, minimum SCF values may be specified, to provide a lower bound for any computed SCF,
using the SCFM (p. 106) command.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
40 of ANSYS, Inc. and its subsidiaries and affiliates.
Stress Concentration Factors
For simple joints in a framed structure these assumptions are often reasonably valid and will provide
good estimates of the structural behavior. For more complex joints, however, the load paths become
much more ill-defined and it is not possible to easily determine their effects on the hot spot stresses.
The influence function approach automatically accounts for load dependency by not only computing
SCF values which are multiplied by the reference brace, but also generating influence terms which are
multiplied by loading in adjacent braces at the joint in question. The key principle involved in this
methodology is the superposition of linear elastic stress fields which enables a hot spot stress to be
computed from the sum of the contributions from all braces at a joint.
The influence functions derived by Efthymiou (Ref. 11 (p. 127)) have been incorporated into FATJACK
and are utilized by including the INFL option in the preliminary data (without this option the conven-
tional SCF values are computed). At present only planar braces are considered in the influence function
computations, the multiplanar effects considered as being small by comparison.
Note that the SCFM command has no effect on computed influence functions.
For any joints where the Efthymiou equations cannot be (or are not) applied, conventional SCF values
are computed (if requested). It is not currently possible to mix conventional SCFs (either explicitly
defined or computed) with influence functions for a given joint.
Note that this normally requires that a non-zero SCF term is given for the in-plane bending term at the
saddle, and the out-of-plane bending term at the crown. For automatically generated terms the following
convention is adopted:
SCFips = SCFipc
SCFopc = SCFops
where:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 41
FATJACK Analysis Methods
ips
in-plane bending saddle
ipc
in-plane bending crown
opc
out-of-plane bending crown
ops
out-of-plane bending saddle
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
42 of ANSYS, Inc. and its subsidiaries and affiliates.
Units
SCFJ 2330 226 BRAC 1.00 1.00 1.00 1.00 1.00 1.00 * UN JOINT
SCFJ 2330 226 CHOR 1.00 1.00 1.00 1.00 1.00 1.00 *
SCFJ 2330 205 BRAC 1.00 1.00 1.00 1.00 1.00 1.00 * UNJOINT
SCFJ 2330 205 CHOR 1.00 1.00 1.00 1.00 1.00 1.00 *
The annotation after each SCFJ command corresponds to the following convention:
SCFJ joint brace BRAC scf values (6) *a joint type equation (6)
a
SCFJ joint brace CHOR scf values (6) * equation (6)
a
equation (6)
where equation (i) is the requested empirical formulation identifier (W, K, D, E) for the printed scf value
(i).
The equation (i) is optionally followed by + or =. If + is printed this signifies that one or more parameters
were exceeded for the given location and the value corresponding to the computed parameters are
reported. If = is printed this signifies that one or more parameters were exceeded for the given location,
and the value corresponding to the limiting parameters are reported.
Other curves may be defined explicitly by providing an ordinate on the curve and associated slope.
Multi-linear curves are supported, as are curves with a cut-off stress below which no damage occurs.
Thickness correction may be applied to the S-N curves to account for varying plate thickness. This cor-
rection (requested using the THIC (p. 117) command) has the effect of shifting the S-N curves to reduce
the fatigue strength with increasing thickness. The correction makes
3.9. Units
FATJACK requires that UNITS (p. 120) are defined for any dimensional input data to FATJACK itself.
Note, however, that the geometric angular data unit defaults to degrees, and wave frequencies are always
defined in Hertz.
The user must ensure that they are consistent with the units adopted in the structural model.
If local modified input data units are required, this is achieved by specifying one or more UNITS (p. 120)
commands within the main body of the FATJACK data thus permitting a combination of unit systems
within the one data file (see UNITS (p. 120) command).
The results units cannot be modified since they are dimensionless or are in non-standard units.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 43
FATJACK Analysis Methods
RESULTS DESCRIPTION
COMPONENT
NO.INSPP No of inspection points
INSP.PNT Inspection point number
CHORD1 First chord number
CHORD2 Second chord number
JT.TYPE Joint type *
CHD/BRC Chord/brace *
S-N S-N table name *
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
44 of ANSYS, Inc. and its subsidiaries and affiliates.
Results presentation
RESULTS DESCRIPTION
COMPONENT
FAIL Failure flag *
CHOR.DIA Chord diameter
CHOR.THK Chord thickness
CHOR.LEN Chord length
CHOR.FIX Chord fixity
BRAC.DIA Brace diameter
BRAC.THK Brace thickness
INSET Inset (TUBE)
ANGLE Inspection point angle (TUBE)
Y-COOR Y coordinate of point on section (non-TUBE)
Z-COOR Z coordinate of point on section (non-TUBE)
SCF.AXBR Brace axial SCF
SCF.IPBR Brace in-plane SCF
SCF.OPBR Brace out-of-plane SCF
SCF.AXCH usChord axial SCF
SCF.IPCH Chord in-plane SCF
SCF.OPCH Chord out-of-plane SCF
USAGE Usage factor
LIFE Fatigue life
RESULTS DESCRIPTION
COMPONENT
JOINT Joint number
BRACE Brace number
WAVE Wave number
CHD/BRC Chord/brace *
ANGLE Inspection point angle (TUBE elements)
DAMAGE Damage per wave
Y-COOR Inspection point Y coord (BEAM elements)
Z-COOR Inspection point Z coord (BEAM elements)
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 45
FATJACK Analysis Methods
Results will be stored under one of the following results types as appropriate:
STRESS RANGE
The results are stored as element results on result set 1 and sub-set IDETM, where IDETM is the system
deterministic case number (1 IDETM NDETM) and NDETM is the number of deterministic cases.
The results are stored as element results on results set LC and sub set 0, where LC is the user wave case
number.
Results components are as tabulated below. Components marked * are stored as character strings:
RESULTS DESCRIPTION
COMPONENT
JOINT Joint number
BRACE Brace number
WAVE Wave number
CHD/BRC Chord/brace *
ANGLE Inspection point angle (TUBE elements)
Y-COOR Inspection point Y coord (BEAM elements)
Z-COOR Inspection point Z coord (BEAM elements)
STRESS Signed peak stress or stress range
UTILS Utilization factor
Components marked + are stored on a per interval basis and require an interval to be entered as the
result position when obtaining the values via the function axlgetelementex.
RESULTS DESCRIPTION
COMPONENT
NO.WAVE Number of spectra
WAVE Spectrum number
NO.TRFUN Number of transfer functions
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
46 of ANSYS, Inc. and its subsidiaries and affiliates.
Results presentation
RESULTS DESCRIPTION
COMPONENT
TR.FUNC Transfer function number
NO.INTVL Number of intervals
ANGLE Inspection point angle
+
OCURENCE Occurrence for stress range interval 1
If option OCRT is specified in a spectral fatigue job, the following element results are saved under results
type OCCUR EACH TRANSFER. The results are stored on result set ITRANS and sub-set ISUB, where ITRANS
is the user transfer function number, ISUB=1 for brace side results, and ISUB = 2 for chord side results
(if they are also stored).
Components marked + are stored on a per interval basis and require an interval to be entered as the
result position when obtaining the values via the function axlgetelementex.
RESULTS DESCRIPTION
COMPONENT
NO.TRFUN Number of transfer functions
TR.FUNC Transfer function number
NO.INTVL Number of intervals
ANGLE Inspection point angle
+
OCURENCE Occurrence for stress range interval 1
If option OCRT is specified in a spectral fatigue job, the following element results are saved under result
type RANGE HISTOGRAM. The results are stored on result set 1 and sub-set ISUB. For brace side results,
ISUB=1. For chord side results (if they are also stored), ISUB=2.
Components marked + are stored on a per interval basis and require an interval to be entered as the
result position when obtaining the values via the function axlgetelementex.
RESULTS DESCRIPTION
COMPONENT
NO.WAVE Number of spectra
NO.TRFUN Number of transfer functions
NO.INTVL Number of intervals
ANGLE Inspection point angle
TOTAL Total occurrence
+
STRESS Stress range for interval 1
+
OCURENCE Occurrence for stress range interval 1
If option OCUR is specified in a time history fatigue job, the following element results are saved under
result type RANGE HISTOGRAM. The results are stored on result set LC and sub-set ISUB, where LC is
the user time history case number, ISUB=1 for brace side results, and ISUB = 2 for chord side results (if
they are also stored).
Components marked + are stored on a per interval basis and require an interval to be entered as the
result position when obtaining the values via the function axlgetelementex.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 47
FATJACK Analysis Methods
RESULTS DESCRIPTION
COMPONENT
NO.WAVE Number of time histories
WAVE Time history number
NO.INTVL Number of intervals
ANGLE Inspection point angle (TUBE elements)
Y-COOR Inspection point Y coord (BEAM elements)
Z-COOR Inspection point Z coord (BEAM elements)
+
STRESS Stress range for interval 1
+
OCURENCE Occurrence for stress range interval 1
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
48 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: FATJACK Command Reference
The data for FATJACK consists of a set of commands which indicate the type of calculation to be per-
formed and the content of the output. The basic data structure is as follows:
Except for stress and time history calculations, FATJACK expects each load condition to consist of a pair
of loadcases representing the real and imaginary parts of the applied cyclic loading. Mechanical APDL
automatically outputs pairs of loadcases if the harmonic option is selected. The term wave case is used
in the FATJACK data description to indicate which pair of cases is being referred to. For example, wave
case 2 refers to the 2nd wave analyzed using the harmonic option or the 3rd and 4th loadcase from a
static analysis.
For stress history analyses a wave case may generate any number of loadcases. For time history analyses,
a wave history case refers to the analysis results obtained for a specific wave condition. The details of
the commands required for each analysis type are given in the following sections.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 49
FATJACK Command Reference
Each horizontal branch represents a possible input instruction. Input instructions are composed of
keywords (shown in UPPER-CASE), numerical values or alphanumerics (shown in lower-case) and
special symbols. Each item in the list is separated from each other by a comma or one or more blank
spaces.
ii. If a real value is specified, the decimal point may be omitted if the value is a whole number.
Exponent formats may be utilized where real numbers are required. For example, the following are
equivalent:
0.004
4.0E-3
4.0D-3
410.0
410
4.10E2
Alphanumerics are any non-numeric strings, which may include the letters A-Z, numbers 0-9, and the
characters +, -, / and :. The letters A-Z may be supplied in either uppercase or lowercase, but no distinc-
tion is made between the uppercase and lowercase form. Hence A is assumed identical with a, B
with b and so on. For example, the following are all permissible alphanumeric strings:
CASE
STR1 END
3mm
COMB
Comb
comb
Alphanumeric strings must not include any special symbols (See Special Symbols (p. 51)).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
50 of ANSYS, Inc. and its subsidiaries and affiliates.
FATJACK Free Format Syntax
If certain lines are optional, these are shown by an arrow which bypasses the line(s):
In order to build up a block of data, a line or a series of lines may need to be repeated until the complete
set has been defined. This is shown by an arrow which loops back:
If certain data items within a command line are optional, these are shown by an arrow which bypasses
the appropriate item:
Some data lines require an integer or real list to be input whose length is variable. This is shown by a
horizontal arrow around the list variable(s):
Where one or more possible alternative items may appear in the list, these are shown by separate
branches for each:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 51
FATJACK Command Reference
' Single quotes are used to enclose some text strings which could contain otherwise
inadmissible characters. The quotes are placed at each end of the string. They may
also be used to provide in-line comments between data items on a given line. For
example:
Note that two commas together signify that an item has been omitted. This may
be permissible for certain data blocks.
Unless otherwise stated in the section describing the data block, omitted
numerical values are zero.
: A colon at the start of the line signifies that the line is a continuation from the
previous line.
For example
5
: 10
: 15
is the same as 5 10 15
@ A command @filename may appear anywhere in a data file. When such a command
is encountered, the input of data switches to the file filename and data continues to
be read from that file until either the end-of-file is reached or an @ command is
encountered in the secondary file.
When the end of the secondary file is reached, that file is closed and input
switches back to the previous data file. If, however, an @ command is found in
the secondary file, input switches to yet another file. This process can continue
until a maximum of 5 secondary files are open simultaneously.
For example
@prelim.dat
@wave.dat
@design.dat
@scf.dat
@spectral.dat
@type.dat
@desi.dat
@gap.dat
@chord.dat
finally
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
52 of ANSYS, Inc. and its subsidiaries and affiliates.
FATJACK Priority of Data Assignments
if none - use element data assigned to the group the element belongs to (GROU)
if none - use element data assigned to the property integer used by the element (PROP)
if none - use step data assigned to the group the element belongs to (GROU)
if none - use step data assigned to the property integer used by the element (PROP)
if none - use element data assigned to the group the element belongs to (GROU)
if none - use element data assigned to the property integer used by the element (PROP)
Element and step data assignment is not order dependant. This is demonstrated by the following example:
COMMand .... data1 ELEM 1
COMMand .... data2 GROU 5
COMMand .... data3 ELEM 2
COMMand .... data4 PROP 1
All elements with property integer 1, except elements 1 and 2 and elements in group 5, have data4 assigned.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
FATJACK Command Reference
It should be noted that when step data is explicitly being defined it overrides any element assignments
even if the step data is assigned to a group or property and the element data assigned to an individual
element. Thus in the following example:
COMMand .... data1 STEP 2 GROU 5
COMMand .... data2 STEP 2 PROP 1
COMMand .... data3 ELEM 1
COMMand .... data4 STEP 2 ELEM 2
Step 2 of element 1 has data1 assigned because the group assignment overrides the property assignment.
In this instance the step specific group assignment also overrides the element assignment which is not
step specific.
Step 2 of all elements with property integer 1, except those in group 5, have data2 assigned.
No data is assigned to any steps, other than step 2, for any elements other than element 1.
Note also that if a command is assigned more than once to a given element, group or property, a
warning will be issued and the last defined value, or values, adopted.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
54 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
The preliminary data must contain at least a JOB (p. 90), STRUCTURE (p. 116) and END (p. 82) command.
Other commands should be used as appropriate.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 55
FATJACK Command Reference
Parameters
ANALYSIS
Keyword
DETERMINISTIC
Keyword to select a deterministic analysis.
SPECTRAL
Keyword to select a spectral fatigue analysis.
STRESS HISTORY
Keyword to select a stress history analysis.
Notes
1. One of these analysis type keywords must appear as the first line after the preliminary data.
2. The analysis type determines the valid commands that may be utilized within the input data file. The fol-
lowing sections Deterministic Analysis (p. 56) to Time History Analysis (p. 69) summarize the available
commands for each type of analysis.
Examples
ANALYSIS SPECTRAL
ANALYSIS STRESS
Target fatigue life (YEAR (p. 123)). Computed lives below this figure will be reported as having failed.
Wave occurrence data in the form of number of occurrences per year (DETE (p. 80)). This data may either
explicitly reference waves that have been analyzed; that is, referred to in the WAVE data, or may consist of
wave height occurrences, in which case interpolation is carried out to obtain member forces for wave heights
that have not been analyzed. This second approach permits a limited number of waves to be structurally
analyzed whilst providing a much more detailed fatigue definition.
Deterministic Commands
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
56 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
SCF BOX
DEFAULT (p. 104)
SCF AUTO Default SCF equations to be used in
DEFAULT (p. 100) generation
SCF AUTO SCF equations to be used at specific joints
JOINT (p. 102)
SCFANGLE (p. 99) SCF values at specific inspection points on
tubular braces
SCFBRACE (p. 103) User defined SCF values for non-tubular
braces
SCFJOINT (p. 105) User defined saddle and crown SCFs
SCFMINIMUM (p. 106)Minimum SCF values
SCFPOINT (p. 107) SCF values at specific inspection points on
non-tubular braces
THICKNESS (p. 117) Requests S-N thickness correction
CURVE (p. 75) User defined S-N damage curve definition
DETE (p. 80) Wave occurrence data C
S-N (p. 110) S-N curve assignment C
YEAR (p. 123) Target fatigue life C
PRINT (p. 95) Report options 5
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 57
FATJACK Command Reference
Usage
C
Compulsory command, but see notes below where applicable.
Notes
1. This data can be generated by FATJACK using the WAVE AUTO (p. 122) command provided the wave loading
was generated using the Mechanical application.
2. Whilst not compulsory it is recommended that a default gap is specified. In the absence of such a command,
braces forming a K or KT configuration will have the gap computed unless specific GAP (p. 84) data is
supplied. This may result in incorrect SCF calculations at joints with simplified modelling.
3. The Marshall Reduction factor is only applicable to SCF values generated using the Kuang equations.
4. The SCF DEFAULT (p. 98) command must be supplied for each section type that is to be processed.
5. In the absence of a PRINT (p. 95) command a detailed report will be produced.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
FATJACK Command Reference
Target fatigue life (YEAR (p. 123)). Computed lives below this figure will be reported as having failed. This is
compulsory.
Transfer function definition. It is normal to assign all the analyzed waves for a given direction to a particular
transfer function. This is achieved using the TRANSFER (p. 119) command which also permits dynamic amp-
lification factors to be applied. This is compulsory.
Sea state spectra definition. For each transfer function a series of sea state spectra are defined using the
SPECTRUM (p. 111) command. A variety of spectra are available viz:
Scott-Weigel
JONSWAP
Pierson-Moskowitz
Ochi-Hubble
Wave spreading effects may be included using the SPREAD (p. 113) command. Three spreading functions
are available including those associated with Mitsuyasu (Ref. 8 (p. 127)) and Goda (Ref. 9 (p. 127)). This command
is optional.
Additional frequencies may be defined at which the transfer function is to be computed. This permits a
limited number of waves to be structurally analyzed whilst providing a more detailed fatigue definition and
is particularly suitable for structures that respond linearly to increasing wave heights. This command is op-
tional.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
60 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
Usage
C
Compulsory command, but see notes below where applicable.
Notes
1. This data can be generated by FATJACK using the WAVE AUTO (p. 122) command provided the wave loading
was generated using the Mechanical application.
2. Whilst not compulsory it is recommended that a default gap is specified. In the absence of such a command,
braces forming a K or KT configuration will have the gap computed unless specific GAP (p. 84) data is
supplied. This may result in incorrect SCF calculations at joints with simplified modelling.
3. The Marshall Reduction factor is only applicable to SCF values generated using the Kuang equations.
4. The SCF DEFAULT (p. 98) command must be supplied for each section type that is to be processed.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 61
FATJACK Command Reference
5. S-N data does not have to be supplied if a stress histogram report has been requested using the PRINT (p. 95)
command.
6. Stress histogram information is only required if requested using the PRINT (p. 95) command.
7. In the absence of a PRINT (p. 95) command a detailed report will be produced.
Secondary elements
Utilizes built in S-N curve with thickness correction and user defined power
Four sea-states
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 63
FATJACK Command Reference
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
Target fatigue life (YEAR). Computed lives below this figure will be reported as having failed.
Wave occurrence data in the form of number of occurrences per year (DETM). This data may either explicitly
reference waves that have been analyzed; that is, referred to in the WAVE data, or may consist of wave height
occurrences, in which case interpolation is carried out to obtain member forces for wave heights that have
not been analyzed. This second approach permits a limited number of waves to be structurally analyzed
whilst providing a much more detailed fatigue definition.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
FATJACK Command Reference
Usage
C
Compulsory command, but see notes below where applicable.
Notes
1. This data can be generated by FATJACK using the WAVE AUTO (p. 122) command provided the wave loading
was generated using the Mechanical application.
2. Whilst not compulsory it is recommended that a default gap is specified. In the absence of such a command,
braces forming a K or KT configuration will have the gap computed unless specific GAP (p. 84) data is
supplied. This may result in incorrect SCF calculations at joints with simplified modelling.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
66 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
3. The Marshall Reduction factor is only applicable to SCF values generated using the Kuang equations.
4. The SCF DEFAULT (p. 98) command must be supplied for each section type that is to be processed.
5. S-N data does not have to be supplied if a stress histogram report has been requested using the PRINT (p. 95)
command.
6. Stress histogram information is only required if requested using the PRINT (p. 95) command.
7. In the absence of a PRINT (p. 95) command a detailed report will be produced.
Secondary elements
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 67
FATJACK Command Reference
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.
Fatigue Analysis method
DETERMINISTIC.DATA 37 568370
DETERMINISTIC.DATA 38 156061
DETERMINISTIC.DATA 39 42851
DETERMINISTIC.DATA 40 11766
DETERMINISTIC.DATA 41 3231
DETERMINISTIC.DATA 42 887
DETERMINISTIC.DATA 43 244
DETERMINISTIC.DATA 44 67
DETERMINISTIC.DATA 45 18
DETERMINISTIC.DATA 46 5
DETERMINISTIC.DATA 47 1
DETERMINISTIC.DATA 48 0
YEAR 50.0
PRIN XCHE DETA USAG SUMM SCFE
STOP
Target fatigue life (YEAR (p. 123)). Computed lives below this figure will be reported as having failed.
Occurrence data of the time histories defined in the HIST (p. 85) data in the form of occurrences per year
(DETE (p. 80)).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 69
FATJACK Command Reference
Usage
C
Compulsory command, but see notes below where applicable.
Notes
1. Whilst not compulsory it is recommended that a default gap is specified. In the absence of such a command,
braces forming a K or KT configuration will have the gap computed unless specific GAP (p. 84) data is
supplied. This may result in incorrect SCF calculations at joints with simplified modelling.
2. The Marshall Reduction factor is only applicable to SCF values generated using the Kuang equations.
3. The SCF DEFAULT (p. 98) command must be supplied for each section type that is to be processed.
4. In the absence of a PRINT (p. 95) command a detailed report will be produced.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
70 of ANSYS, Inc. and its subsidiaries and affiliates.
ACCE
4.5. ACCE
The ACCE command defines the value for gravitational acceleration required for spectral fatigue analysis.
Parameters
ACCE
Keyword
gravity
Gravitational acceleration (Real).
Notes
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 71
FATJACK Command Reference
1. This command is optional for a SPECTRAL (p. 59) analysis. If not defined the program will adopt a value of
9.81 metres/sec2 (converted into the appropriate analysis units). If required the default value may be
overwritten using the ACCE command.
Examples
ACCE 32.2
4.6. ALLOWABLE
The ALLOWABLE command is used to request that the computed stress value from a Stress History
Analysis is compared with a target (limit) value when PRINT PEAK (p. 95) or PRINT RNGE (p. 95) is also
requested. If the command is used FATJACK will report a utilization factor rather than a direct stress.
Parameters
ALLOWABLE: Keyword.
value: Allowable stress to the actual stress (PEAK or RNGE) is compared. (Real).
Notes
4.7. ANSYS
The ANSYS command defines the name of the Mechanical APDL job(s) from which the analysis results
will be obtained.
The ANSYS command is a preliminary command, and should only appear at the head of the
FATJACK data set.
Parameters
ANSYS
Keyword
FNAME
Keyword to denote that the job names are specified in a job name list file (Optional).
Jobname
without FNAME job name of the Mechanical APDL model to be processed. This is the name associated
with the .RST file generated by Mechanical APDL (Alphanumeric, up to 32 characters).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
72 of ANSYS, Inc. and its subsidiaries and affiliates.
CHORD
with FNAME name of file containing paths and names of Mechanical APDL jobs to be included in the
analysis together.
youngs
Young's Modulus (Optional, Real).
density
Material density (Optional, Real).
Usage
The command is mandatory if FATJACK is to be performed following a Mechanical APDL analysis and
must be omitted otherwise.
Notes
1. FATJACK will only process certain Mechanical APDL beam element types in a Mechanical APDL model.
Valid element names are:
2. FATJACK will not automatically identify the orientation of members at joint locations. Therefore, section
information of non-tubular members must be defined using the DESIGN (p. 79) command.
Examples
1. The Mechanical APDL analysis is a single job called ANSYSJOB. All the load cases in this job will be analyzed
in FATJACK.
ANSYS ANSYSJOB
2. The Mechanical APDL analysis information is contained in a job name file called Ansysfile.txt, which
references three Mechanical APDL jobs called Ansysjob1, Ansysjob2 and Ansysjob3 located in different
directories.
ANSYS FNAME Ansysfile.txt
C:\AnsysAnalysis\Job1\Ansysjob1
C:\AnsysAnalysis\Job2\Ansysjob2
C:\AnsysAnalysis\Job3\Ansysjob3
4.8. CHORD
The CHORD command allows specific elements to be defined as chord members at a particular joint.
Optional chord lengths and end fixity may also be defined if required.
Parameters
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 73
FATJACK Command Reference
CHORD
Keyword
joint
Joint number at which the chord is being defined (Integer).
member
User element number defining a segment of the chord associated with the specified joint. If computed
chord lengths are required then all the members defining the chord must be supplied (Integer).
LENGTH
Keyword to indicate that the chord length is to follow.
length
Length of the chord to be used in SCF computations. (Real).
FIXITY
Keyword to indicate that the chord end fixity parameter is to follow.
para
Chord end fixity parameter used in the computation of SCF values using Efthymiou equations. (Real).
Usage
This command is compulsory if joints modelled with two or three nodes points are required.
Notes
1. For joints modelled with a single node, this command is optional and the criteria for selecting chord elements
are described below. In cases where the chord member is segmented, however, it is suggested that a chord
command is supplied in order that the correct chord length is utilized in any automated SCF computations.
ii. From those selected in (i), select all tubes with largest thickness.
iii. If the list selected in (ii), contains only one element then this becomes the chord.
iv. If the list selected in (ii), contains more than one element then the list is checked for a pair of co-linear
elements forming a through member. If only one pair is found then these elements for the chord.
v. If no unique chord element(s) can be found then automatic SCF calculation is not possible. In these
circumstances, the chord element(s) must be defined manually.
vi. The chord length is computed as 2/3 of the combined lengths of the chosen chords. The chord end
fixity parameter is set to 0.7.
2. If K or KT joints are to be modelled with more than one node, a chord command must be supplied to
provide the connectivity information between the nodes at the joint. For KT joints modelled with three
nodes, the joint number must be the central node and the chord elements must connect the three braces
together (See the TYPE (p. 119) command).
3. If not defined, the chord length is computed as 2/3 of the combined lengths of the selected chord elements.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
74 of ANSYS, Inc. and its subsidiaries and affiliates.
CURVE
Examples
CHOR 2000 2010 2020 2030 2040
CHOR 10 110 120 LENG 20.0
CHOR 105 1150 1250 FIX 0.8
CHOR 20 120 LENG 18.5 FIX 0.7
4.9. COMPONENT
The COMPONENT command is used to define the component to be processed from a substructure
analysis.
The COMP command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
COMPONENT
Keyword
sname
Structure name identifying which existing structure is to be accessed from the current project, see the
PROJ (p. 96) command (Alphanumeric, 4 characters, the first character must be alphabetic).
tree
This is the path down the component tree from the given structure in sname to the component which is
being used for the FATJACK processing.
Usage
Notes
1. If the user is processing the global structure run in a substructure analysis, use only the STRU (p. 116)
command.
Examples
To process the second level component CMP2, part of assembled component CMP1, which in turn is
part of structure STRU:
COMP STRU CMP1 CMP2
4.10. CURVE
The CURVE command defines the relationship between stress range and number of cycles to failure
used in computing the damage contribution of the applied wave loading.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 75
FATJACK Command Reference
Standard curves available within FATJACK do not need to be defined unless non-standard base
thicknesses are required for thickness correction.
Parameters
CURVE
Keyword
name
Alphanumeric identifier to be associated with this curve (up to 4 characters).
SINGLE
Keyword to denote a single slope curve is being defined.
MULTI
Keyword to denote a multi-linear curve is being defined.
LIMIT
Keyword to denote a single slope curve with a cut-off stress is being defined.
stress, cycle
Point lying on a given section of the S-N curve. For multi-linear curves the point must correspond to the
intersect within the adjacent section. For limiting curves the point must correspond to the cut-off position
(Real).
slope
Slope of a given section of the S-N curve (Real).
THICK
Keyword to indicate that a base thickness is to be provided.
base
Base thickness to be used if thickness correction requested (Real).
Notes
1. The requirement for the ordinates of user defined multi-linear S-N curves to be at the intersection of adjacent
sections is that two pairs of ordinates will be the same, but with differing slopes. This can be seen in the
internal representations of DET and DEF2 design curves (p. 77) (which are both bi-linear).
2. The base thickness is used when thickness correction of the S-N curve is requested (using the THICK-
NESS (p. 117) command). For user defined curves a base thickness must be provided if the correction is to
be applied.
Examples
CURV DOC LIMIT 32.0 2.0D8 3.56
CURV DSC MULTI 73.0 1.0D7 3.56
: 73.0 1.0D7 4.56
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
76 of ANSYS, Inc. and its subsidiaries and affiliates.
CURVE
Parameters
CURVE
Keyword
curve
Predefined S-N curve name. Only required when base thickness is to be modified from the default value.
The following curves are currently available:
THICK
Keyword to indicate that a base thickness is to be provided.
base
Base thickness to be used if thickness correction requested (Real).
Note
Although the above curves are given in N and mm, any user entries are in data input units.
2. The base thickness is used when thickness correction of the S-N curve is requested (using the THICK-
NESS (p. 117) command). For the predefined curves (with the exception of the DOT curve) a default base
thickness is adopted unless otherwise overridden by the user. For the DOT curve, no default base thickness
is available and a user defined value must be provided if thickness correction is required.
Example
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 77
FATJACK Command Reference
4.11. CYCLE
The CYCLE command defines the number and sizes of the stress range intervals for rainflow counting.
Parameters
CYCLE
Keyword
nint
Number of intervals to sample stress range (Integer, >0).
sigmax
Peak stress range required. If zero or not specified, the peak is determined automatically from the stress
time history (Real, >=0.0).
sig1
Stress range limit for the first interval (Real, >=0.0).
Usage
Notes
1. If sigmax and sig1 are both specified, sigmax must be larger than sig1.
2. If sig1 is not specified, the nint intervals will be set equally between zero and sigmax or the program de-
termined peak value if this is not defined.
3. If sig1 is specified, the first stress range interval will be taken as between zero and sig1. The rest (nint-1)
intervals will be set equally between sig1 and sigmax or the program determined peak value if this is not
defined.
Examples
CYCLE 50
CYCLE 50 10.0E6 1.0E6
If you had a number of stress ranges counted, say: 1.1, 1.9, 3.1, 4.4, 9
If you use CYCLE 3 10.5, then you would get counting results with the following:
0 3.5 :3
3.5 - 7.0 :1
7.0 - 10.5 :1
If you use CYCLE 3 then you would get counting results with the following:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
78 of ANSYS, Inc. and its subsidiaries and affiliates.
DESIGN
03 :2
3-6 :2
6-9 :1
If you use CYCLE 3 10 2, then you would get counting results with the following:
02 :2
2-6 :2
6 - 10 :1
4.12. DESIGN
The DESI command enables geometric properties from the structural analysis to be overridden to account
for design requirements. The design properties are used for computing member stresses and SCF values.
In the absence of any design data the geometric information from the analysis will be adopted.
Parameters
DESIGN
Keyword
type
Section type (Alphanumeric). Valid profiles are:
TUB
Tube
WF
Doubly symmetric Rolled I-section (for example, UB, UC, Joist,WFC, WF)
RHS
Rectangular Hollow Section (RHS)
BOX
Fabricated Box Section
values
Values defining the section dimensions appropriate to the section type. See Section Profile Informa-
tion (p. 125) for details (Real).
STEP
Keyword to indicate the step number is to follow.
istep
Step number for non-prismatic elements. Values should either be 1 or the last step number for the element.
Alternatively the keywords END1 or END2 may replace STEP istep.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 79
FATJACK Command Reference
ELEMENT
Keyword to denote selection by element numbers.
GROUP
Keyword to denote selection by element group numbers.
PROPERTY
Keyword to denote selection by geometric property integer.
list
List of user element, group or geometric property numbers for which this data is to be assigned. The list
may include the keyword TO but not ALL.
Notes
2. If a step reference is given only that step for the elements specified within the element, group or property
list will be assigned the new section data.
3. See FATJACK Priority of Data Assignments (p. 53) for order of priority for ELEMENT/GROUP/PROPERTY
lists.
4. If insets are defined for the end of a brace, any design properties defined for the same end will be applied
at the inset position.
Examples
DESI TUB 2.0 0.04 ELEM 100 TO 110
DESI TUB 1.5 0.032 END1 ELEM 1010
DESI BOX 2.0 1.5 0.04 0.032
4.13. DETE
The DETE command defines the wave occurrence data required for deterministic and stress history
analyses. Facilities exist to include additional wave definitions that were not included in the wave ana-
lysis. This command is also required in time history analysis to define the occurrence of each time history
case.
Parameters
DETE
Keyword
case
Wave case number to which this occurrence data relates (Integer).
ncycle
Number of cycles per year for this wave case (Integer).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
80 of ANSYS, Inc. and its subsidiaries and affiliates.
DETE
HEIGHT
Keyword to denote that the occurrence data is to be given in terms of a reference height for a given direc-
tion.
height
Reference wave height (Real).
direction
Reference wave direction (Real, degrees).
DAF
Keyword to denote that the occurrence data is to be given as probability.
daf
Dynamic amplification factor.
PROB
Keyword to denote that the occurrence data is to be given as probability.
pval
Occurrence probability of the wave history case (Real, >+0.0).
Notes
1. For wave cases generated using the WAVE AUTO (p. 122) command, these are numbered sequentially from
1.
2. If the dynamic amplification factor keyword and value are not supplied, unity is assumed. The dynamic
amplification factor data is always ignored in the time history analyses.
3. The use of occurrence data relating to reference wave height provides a flexible means to develop the
occurrence data without use of wave case numbers and permitting additional wave height data to be
defined that were not previously analyzed.
For a given wave direction each height defined on a DETE command is related to the associated
analyzed wave cases for the same wave direction.
Stress values for the reference wave height are obtained by linear interpolation between adjacent
wave heights. Stresses for reference wave heights which are below the lower limit of the analyzed
wave cases will be obtained by factoring the limit value.
Stresses for reference wave heights which are above the upper limit of the analyzed wave cases will
be obtained by linear extrapolation of the last two cases. This is shown diagrammatically below.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 81
FATJACK Command Reference
Using this facility, all wave occurrence data may be defined by reference to the wave height, thus
obviating the need to refer to an analyzed wave case number.
5. Keyword PROB is only allowed in time history analyses. However if it is specified, then it must be used for
all DETE commands. The units in which the probability is input are immaterial providing that they are
consistent throughout. The program computes a true probability for each history by dividing each input
probability by the sum of all the probabilities.
Examples
DETE 1 150000
DETE 2 124500 DAF 1.05
4.14. END
The END command is used to terminate a command data block.
The END command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
END
Keyword
Usage
4.15. FILES
The FILES command is used to define the prefix name for the backing files created in this run.
The FILES command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
FILES
Keyword
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
82 of ANSYS, Inc. and its subsidiaries and affiliates.
FREQUENCY
fname
Prefix name for any backing files created by this run. (Alphanumeric, 4 characters, first character must be
alphabetic).
Usage
Notes
1. fname is used as a prefix for all files created during the current run. The four characters are appended with
two digits in the range 12 to 35 to create each individual file.
Examples
FILES BILL
4.16. FREQUENCY
The FREQUENCY command permits the definition of additional frequencies at which the stress transfer
function is to be evaluated in spectral analyses.
Parameters
FREQUENCY
Keyword
trans
Transfer function number to which these additional frequencies are to be added (Integer).
freq-list
List of frequency values. (Real, Hertz).
Notes
1. The frequencies defined MUST lie between the maximum and minimum frequencies associated with the
analyzed wave load cases forming the transfer function.
2. Stresses associated with the additional frequencies will be obtained by linear interpolation of stresses ob-
tained from adjacent (by frequency) factored analyzed wave loadcases which form the transfer function.
3. The frequency values must be given in Hertz, this cannot be changed by the use of UNITS (p. 120) com-
mand(s).
Examples
FREQ 10 0.142 0.150 0.175
: 0.210 0.225
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 83
FATJACK Command Reference
4.17. GAP
The GAP command allows specific gap information to be defined between pairs of braces forming K
and KT joints. For overlapping joints the through member is also defined.
Parameters
GAP
Keyword
joint
Joint number at which the gap is being defined (Integer).
brace
User element number specifying a brace forming part of a K or KT configuration about which the gap is
to be defined (Integer).
brace2
Second user element number corresponding to the second brace (Integer).
gap
User defined gap between braces brace and brace2. For overlapping gaps this dimension should be
negative (Real).
THRU
Keyword to indicate that through brace information is to follow for overlapping braces. Only permissible
if gap is negative.
braced
Brace element number representing the through member. Must be either brace or brace2 defined in this
command (Integer).
Notes
1. If GAP is not specified for a given K or KT joint, the gap adopts the value specified in the GAPDE-
FAULT (p. 85) command. If the default gap dimension has not been defined the gap is computed based
upon model geometry. Where gap dimensions are computed these may be reset during the SCF computa-
tions to prevent the use of gap values which would cause the SCF formulations becoming insoluble.
2. The Efthymiou SCF equations permit overlapping K and KT joints. This may be specified by defining a
negative gap value representing the length of the overlap. Under these circumstances, a through brace
must be defined since the equations differ for the through and overlapping member.
Examples
GAP 1100 1100 1110 50.0
GAP 1200 1200 1210 -35.0 THRU 1200
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
84 of ANSYS, Inc. and its subsidiaries and affiliates.
HIST
4.18. GAPDEFAULT
The GAPDEFAULT command is used to specify a default gap dimension to be used between pairs of
braces forming K and KT joints where specific gaps have not been defined.
Parameters
GAPDEFAULT
Keyword
equation
Equation type to which this default gap applies. Valid options are:
W
Wordsworth
K
Kuang
D
DS449
E
Efthymiou
gap
Default gap dimension (Real).
Notes
1. If GAPDEFAULT is not specified and a specific gap value is not defined for a given pair of braces forming
a K or KT joint, the gap dimension is computed based upon model geometry. Since joint geometry is often
simplified computed gaps may lead to erroneous values of generated stress concentration factors.
2. If gap dimensions are computed these may be reset during the SCF computations to prevent the use of
gap values which would cause the SCF formulations becoming insoluble.
Examples
GAPDEFAULT WORDSWORTH 50.0
4.19. HIST
The HIST command defines details of the analysis time histories to be included in a time history fatigue
analysis.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 85
FATJACK Command Reference
Parameters
HIST
Keyword
case
Wave history case number (Integer, > 0).
stru
For ASAS name of structure from which data is going to be obtained, structure must be in the same
project as that specified in preliminary data. If omitted, defaults to structure name given in the prelim-
inary STRUCTURE (p. 116) command (Alphanumeric, 4 characters), or
For ANSYS job identification name for the ANSYS job. If omitted, defaults to be first job referenced
(Alphanumeric, up to 8 characters).
start
First system loadcase (load step) to use from this analysis for rainflow counting. If omitted or 0, defaults
to 1 (Integer, >= 0).
end
Last loadcase (load step) to use from this analysis for rainflow counting. If omitted or 0, defaults to the last
loadcase analyzed. (Integer, >= 0).
interval
Interval between loadcases to use. If omitted or 0, defaults to 1. (Integer, >= 0).
Notes
1. If an optional value is specified, all preceding optional values must also be specified.
2. The ANSYS job identification name is formed by packing the structure name given in the preliminary
STRUCTURE (p. 116) command with the position of the job in the job name list file specified in the AN-
SYS (p. 72) command. For example, ABCD18 means that the structure name is ABCD and the relevant job
is the 18th one in the list of jobs that appear in the job name list file.
Examples
HIST 1 aaaa 1 1001 1
HIST 2 bbbb
HIST 3
4.20. INSET
The INSET command defines the position along a brace at which the fatigue calculations are to be
computed. This is intended to account for moment back-off to the chord/brace interface.
Parameters
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
86 of ANSYS, Inc. and its subsidiaries and affiliates.
INSPECTION
INSET
Keyword
joint
Joint number at which the brace is connected (Integer).
brace
User element number to which the inset is to apply (Integer).
value
Inset value, positive values corresponding to moving along the brace away from the joint. The value should
not be greater than the element length (Real).
Notes
1. The value of the inset is added to any offsets modelled in the analysis for this brace.
2. The value of the bending moment used in the fatigue calculation is normally that occurring at the offset
end of the brace element connected to the joint. This value can sometimes be reduced by computing an
adjusted bending moment at the chord/brace interface; that is, at a distance of D/2 from the brace element
end, where D is the chord diameter.
3. The value of the bending moment will be computed by assuming that the member is subjected to a uni-
formly distributed load, the magnitude of which is calculated from a difference in the end shears.
4. Use of this command to generate results well away from the nodal positions may provide misleading fatigue
lives due to the loading assumptions described in Note 3 above.
5. If design properties are given for the end of a brace at which an inset is defined, the properties will apply
to the inset location.
Examples
INSET 1000 1101 0.8
4.21. INSPECTION
This section discusses the following topics:
4.21.1. INSPECTION Command (Tubular sections)
4.21.2. INSPECTION Command (Non-tubular sections)
Parameters
INSPECTION
Keyword
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 87
FATJACK Command Reference
ninsp
Number of inspection points to be generated (Integer).
ELEMENT
Keyword to indicate that a brace element list is to follow.
list
List of user brace element numbers to be assigned the inspection points (Integer).
ANGLE
Keyword to indicate that explicit inspection angles are to be defined.
joint
Joint number at which the brace being defined is connected (Integer).
brace
User element number to be assigned the inspection points (Integer).
theta
List of angles, measured in degrees from the saddle location (see below) (Real).
Notes
1. This command is optional. If omitted, or for elements not specified on INSPECTION commands, a default
of four inspection points will be generated corresponding to angles of 0, 90, 180 and 270 from the primary
saddle location (see Note 5 below).
2. If the ELEMENT keyword and associated list is omitted then the inspection points defined will apply to all
elements (unless overridden by explicit definitions for specific elements).
3. If inspection points are generated then they will be equi-spaced with the first point at 0 degrees (primary
saddle) and subsequent points with angles increasing by 360/ninsp. Thus if ninsp is 8 then the following
angles will be generated:
5. Generated and explicit angles are measured relative to a saddle location. The location of the saddle and
the relationship of other inspection points to this are shown below:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
88 of ANSYS, Inc. and its subsidiaries and affiliates.
INSPECTION
For details of how the axis system is determined see Tubular Joint Inspection Points (p. 37).
Examples
INSP 8
INSPECTION 12 ELEMENT 5 TO 10
INSPECTION ANGLE 200 2010 0.0 51.0 96.0 132.0
Parameters
INSPECTION
Keyword
SYMM
Keyword to indicate that 4 symmetric inspection points are to be defined.
POSN
Keyword to indicate that specific inspection points are to be defined.
y, z
Pair of ordinates defining a point on the beam section in local y and z directions (Real).
ELEMENT
Keyword to indicate that a brace element list is to follow.
list
List of user brace element numbers to be assigned the inspection points (Integer).
joint
Joint number at which the brace being defined is connected (Integer).
brace
User element number to be assigned the inspection points (Integer).
Notes
1. If sections have been utilized in the analysis the program will default to four inspection points as shown
in Section Profile Information (p. 125). The use of the INSPECTION command may be used to overwrite this
default.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 89
FATJACK Command Reference
4. No checks are carried out to ensure that the inspection point ordinates lie within the section (if defined).
Examples
INSPECTION SYMM 0.4 0.3
INSPECTION SYMM 425.0 250.0 ELEMENT 5 TO 10
INSPECTION POSN 200 2010 0.5 0.3 -0.5 0.3
4.22. JOB
The JOB command is used to define the type of analysis for the current run.
The JOB command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
JOB
Keyword
POST
Keyword indicating post-processing of an analysis.
Usage
Compulsory.
Examples
JOB POST
4.23. JOINT
The JOINT command is used to select the joints at which the fatigue lives are to be computed. FATJACK
will generate a list of valid brace elements that are connected to the selected joints.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
90 of ANSYS, Inc. and its subsidiaries and affiliates.
LIMIT
Parameters
JOINT
Keyword
nodelist
User list of node numbers which equate to the required joints. Keywords ALL and TO may be utilized if
required (Integer).
Usage
Compulsory.
Notes
1. This command is compulsory and may be repeated as often as required to define the problem.
2. Braces connected to the joint which are not required in the fatigue calculation may be ignored using the
SECONDARY (p. 108) command.
3. Joints of K and KT configurations which have been modelled using two or three nodes require a reference
node to define the joint. Only the reference node should be defined on the JOINT command. For further
details see Joint Selection (p. 35).
Examples
JOINT ALL
JOINT 56 TO 66
JOINT 104 107 116 235
4.24. LIMIT
The SCF generators utilize parametric equations which have been derived for a limited range of values
for the parameters involved. The limiting values defined below are built into FATJACK, but these may
be overwritten, at the users discretion, using one or more LIMIT commands.
Parameters
LIMIT
Keyword
calc
Alphanumeric defining the equation type to which this limit applies. Permitted values are:
KUANG
WORDSWORTH
DS449
EFTHYMIOU
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 91
FATJACK Command Reference
limval
Keyword indicating parameter for which default applicability limit is to be overwritten (Alphanumeric).
Permitted values are:
ALPHA
BETA
GAMMA
TAU
THETA
minval
Lower applicability limit for parameter limval (Real).
maxval
Upper applicability limit for parameter limval (Real).
Notes
1. Default applicability limits are as follows (using the standard parameter definitions):
2. For any joint for which one or more parameters lie outside the limit values the SCF values will be calculated
with the actual values of the parameters and then recalculated with the appropriate parameters reset to
the limit values. The highest SCF value thus obtained will be taken.
If influence functions are being employed, coefficients at both the actual parameter and limiting
value are computed and stored. The critical hot spot stress is then computed as the maximum util-
izing either the actual or limiting parameter coefficients.
Examples
LIMIT KUAN ALPHA 10.0 35.0
LIMIT WORDSWORTH BETA 0.2 1.0
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
92 of ANSYS, Inc. and its subsidiaries and affiliates.
OPTIONS
4.25. NEWSTRUCTURE
The NEWSTRUCTURE command is used to define a new structure name to be associated with the results
created by the current run.
The NEWSTRUCTURE command is a preliminary command, and should only appear at the head
of the FATJACK data set.
Parameters
NEWSTRUCTURE
Keyword
nsname
Structure name to be associated with the results being created by the current run in order to identify these
results from others in the project. nsname must be unique for this project (Alphanumeric, 4 characters).
Usage
Optional.
Notes
1. If the NEWSTRUCTURE command is omitted then nsname defaults to the name ASNN. However, since the
structure name must be unique within a project, the default must not be assumed more than once if the
project contains a series of restarts.
2. A STRUCTURE (p. 116) command is normally required in conjunction with NEWSTRUCTURE to define the
name of the existing structure.
4.26. OPTIONS
The OPTIONS command is used to define the control options for this run.
The OPTIONS command is a preliminary command, and should only appear at the head of the
FATJACK data set.
Parameters
OPTIONS
Keyword
option
Four character option name, or list of option names. The following options are available:
INFL - Requests that SCF calculations employing the Efthymiou empirical formulations are to use the
load influence methodology (See Joint Selection (p. 35)).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 93
FATJACK Command Reference
REFL - If wave spreading has been requested (using the SPREAD (p. 113) command), this option will select
wave cases in the opposite quadrant to couple with the requested direction (that is, reflecting the wave
by 1800).
SCFG - requests that a formatted SCF file is generated from any automatic SCF computations. No fatigue
life calculations will be undertaken. The SCFs will be written to filegs, where file is the 4 character file
name associated with this run (see FILES (p. 82)).
GOON - Proceed even after printed WARNINGS. This option allows the run to continue beyond the data
checks despite questionable data. It should only be used after a run in which the WARNINGS have been
noted and rejected as unimportant.
Usage
Optional.
Examples
OPTIONS INFL
4.27. PARAMETER
Program calculated values of most parameters for specific braces at a previously defined joint may be
overwritten using the PARAMETER command. This enables the user to calculate SCF values using
geometry.
Parameters
PARAMETER
Keyword
joint
Joint number to which the brace is connected (Integer).
param
Keyword indicating the parameter for which the calculated value is to be overwritten for SCF calculation.
Permitted values:
ALPHA
BETA
GAMMA
TAU
THETA
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
94 of ANSYS, Inc. and its subsidiaries and affiliates.
PRINT
pval
Value of parameter param to be used in SCF calculation (Real).
brace
Brace number for which parameter param is to be updated. This element must be connected to the pre-
viously defined joint (Integer).
Examples
PARAMETER 1100 BETA 0.6 110010
4.28. PRINT
The PRINT command is used to select the type of results to be reported and the format of the report.
If omitted the default report is provided.
Parameters
PRINT
Keyword
report-item
Keyword identifying what information is to be reported. Valid names are:
XCHECK
Requests printing of cross checking information of input data.
SCFE
Requests a separate table of SCF information.
BRIEF
Brief fatigue report consisting of one line per joint/brace pair.
DETAILED
Standard fatigue report. Results are grouped by joint and provides lives at the worst inspection point
for a given brace.
FULL
Expands the BRIEF or DETAILED reports to include results for all inspection points.
SCFP
Adds SCF information to the BRIEF or DETAILED reports.
USAGE
Adds usage factor information to the BRIEF or DETAILED reports.
SUMMARY
Creates a summary report of braces which fail the fatigue target life.
DAMW
Requests damage per wave or sea-state. This is in addition to any other fatigue reports requested.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 95
FATJACK Command Reference
OCUR
Selects printing of stress ranges versus occurrences for spectral and time history analysis.
OCRT
As OCUR but produces results from for each transfer function for spectral analysis.
OCRW
As OCRT but produces results for each wave spectrum for spectral analysis.
PEAK
Requests that the stress peak value (+ve or -ve) is reported in a stress history analysis.
RNGE
Requests that the stress range is reported in a stress history analysis.
Notes
2. FULL, SCFP and USAGE must be used in combination with BRIEF or DETAILED.
3. For spectral analyses with OCUR/OCRT/OCRW a SIGM (p. 109) command must be provided to define the
sampling points for the table. All other options (except XCHE and SCFE) are ignored.
4. PEAK/RNGE are only valid for stress history analyses and are mutually exclusive.
5. DAMW and OCRT/OCRW may produce large amounts of information and should be used only for selective
fatigue runs.
6. PRINT commands are cumulative so required reports may be requested individually or on one or more
lines.
Examples
PRINT BRIEF FULL SCFP SUMMARY
PRINT XCHECK DETAILED DAMW
4.29. PROJECT
The PROJECT command is used to define the project name for the current run.
The PROJECT command is a preliminary command, and should only appear at the head of the
FATJACK data set.
Parameters
PROJECT
Keyword
pname
Project name for current run (Alphanumeric, 4 characters, first character must be alphabetic).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
96 of ANSYS, Inc. and its subsidiaries and affiliates.
RESU
Usage
Notes
1. All runs with the same project name access the same database. A project database consists of one project
file (with a file name consisting of the 4 characters of pname with the number 10 appended), which acts
as an index to other files created under this project, together with those other files.
Examples
PROJECT HIJK
4.30. REDUCTION
The REDUCTION command requests the use of the Marshall Reduction factor for brace side SCF values
computed using the Kuang equations.
Parameters
REDUCTION
Keyword
factor
Optional factor to be applied (Real).
Usage
Notes
1. If this command is omitted completely no brace side reduction will take place.
2. If the factor is omitted, a default value of 0.63 will be utilized (as suggested by API).
Examples
REDUCTION
REDU 0.7
4.31. RESU
The RESU command is used to specify saving of results to the results database.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 97
FATJACK Command Reference
The RESU command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
RESU: Keyword.
Notes
1. For the results database to be used in any post-processing run with the ASAS solvers a RESU command
must be included in the initial ASAS run to initialize the database.
Examples
RESU
Explicit and generated SCF values may be mixed as necessary to achieve the desired result.
A summary of available commands is shown below with detailed descriptions given in the following
sections.
Note that if influence functions are used to compute the hot spot stresses for braces at a given joint,
it is not currently possible to override the computed influence terms with conventional SCFs. Any user
specified values will be ignored.
Command Description
SCF TUB Specifies default SCF values for a given section type
DEFAULT (p. 104)
SCF WF
DEFAULT (p. 104)
SCF RHS
DEFAULT (p. 104)
SCF BOX
DEFAULT (p. 104)
SCFJOINT (p. 105) Specifies crown and saddle SCF values at specified joints for tubular braces
SCFANGLE (p. 99) Specifies SCF values at specific angular inspection points for tubular braces
SCFBRACE (p. 103) Specifies SCF values at all inspection points for non-tubular braces
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
98 of ANSYS, Inc. and its subsidiaries and affiliates.
SCF Definition
Command Description
SCFPOINT (p. 107) Specifies SCF values at specific inspection points for non-tubular braces
Command Description
SCF AUTO Specifies default empirical equation(s) to be utilized for the SCF generation
DEFAULT (p. 100)
SCF AUTO JOINT (p. 102) Specifies joints at which automatic computation of SCF values to be undertaken
SCFMINIMUM (p. 106) Specifies minimum values for the SCF components calculated in automatic
generation
LIMIT (p. 91) Permits user defined applicability limits for the parameters utilized in automatic
SCF generation
PARAMETER (p. 94) Permits explicit definition of the parameters utilized in automatic SCF generation
for specific braces
Parameters
SCFANGLE
Keyword
joint
Joint number to which the brace is connected (Integer).
brace
Brace user element number for which the SCF values are to be specified (Integer).
angle
Angle (in degrees) from inspection point 1 (Real).
bscfa
Brace side SCF for axial force (Real).
bscfip
Brace side SCF for in-plane bending (Real).
bscfop
Brace side SCF for out-of-plane bending (Real).
cscfa
Chord side SCF for axial force (Real).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 99
FATJACK Command Reference
cscfip
Chord side SCF for in-plane bending (Real).
cscfop
Chord side SCF for out-of-plane bending (Real).
Notes
1. If only bscfa is specified, this value will be adopted for all six SCF values.
2. If SCFANGLE is used for a brace, results will only be computed at those inspection points explicitly defined
by the angles provided in the SCFANGLE commands. Any INSPECTION (p. 87) commands referring to this
brace end will be ignored. This implies that the SCF values at ALL inspection points need to be provided.
Where crown and saddle SCF values are known, use should be made of the SCFJOINT (p. 105) command.
3. For any given brace, SCFANGLE and SCFJOINT (p. 105) are mutually exclusive and cannot be used together
in the same run of FATJACK.
Examples
SCFA 1100 110010 45.0 3.5 5.0 5.0 3.5 5.0 5.0
SCFANGLE 85 1185 90.0 4.5
Parameters
SCF
Keyword
AUTO
Keyword
DEFAULT
Keyword
GENERAL
Keyword to denote that the equation matrix is applied to all joint types (unless overwritten).
type
Joint type to which this default matrix is to be applied (Alphanumeric). Valid joint types are:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
100 of ANSYS, Inc. and its subsidiaries and affiliates.
SCF Definition
KT
matrix
Defines the empirical formulations to be adopted for the following stress components and locations:
The matrix consists of a series of characters representing the equation type to be used for each of
the stress components and locations above. Valid options are:
W
Wordsworth
K
Kuang
D
DS449
E
Efthymiou
Notes
2. If only one value is provided then this will be used for all stress components and locations. Either one or
eight equation identifiers must be defined.
3. If influence functions are employed then only Efthymiou equations may be requested. Other equation
types will produce an error.
Examples
SCF AUTO DEFA GENE K K W W K K W W
SCF AUTO DEFAULT KT E
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 101
FATJACK Command Reference
Parameters
SCF
Keyword
AUTO
Keyword
JOINT
Keyword
matrix
Defines the empirical formulations to be adopted for the following stress components and locations for
the braces connected to the specified jointlist:
The matrix consists of a series of characters representing the equation type to be used for each of
the stress components and locations above. Valid options are:
W
Wordsworth
K
Kuang
D
DS449
E
Efthymiou
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
102 of ANSYS, Inc. and its subsidiaries and affiliates.
SCF Definition
jointlist
List of joints at which automatic SCF generation is to be undertaken. Keywords ALL and TO may be gen-
erate lists of joints (Integer).
Notes
1. If the matrix is omitted the default matrices for the brace configurations occurring at the specified joint
will be adopted.
2. If the matrix is specified it will be used for all braces connected to the specified joints irrespective of the
brace configurations.
3. If only one value is provided for the matrix then this will be used for all stress components and locations.
If any locations are different then all eight equation identifiers must be defined.
4. If influence functions are employed then only Efthymiou equations may be requested. Other equation
types will produce an error.
Examples
SCF AUTO JOINT ALL
SCFANGLE 85 1185 90.0 4.5
SCF AUTO JOIN E 10 TO 25
SCF AUTO JOIN K K W W K K W W 100 200 300
Parameters
SCFBRACE
Keyword
joint
Joint number to which the brace is connected (Integer).
brace
Brace user element number for which the SCF values are to be specified (Integer).
bscfa
Brace side SCF for axial force (Real).
bscfip
Brace side SCF for in-plane bending (Real).
bscfop
Brace side SCF for out-of-plane bending (Real).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 103
FATJACK Command Reference
cscfa
Chord side SCF for axial force (Real).
cscfip
Chord side SCF for in-plane bending (Real).
cscfop
Chord side SCF for out-of-plane bending (Real).
Notes
1. If only bscfa is specified, this value will be adopted for all six SCF values.
2. SCF values defined will be applied at each of the inspection points defined using the INSPECTION (p. 87)
command. If different values are required at each inspection point the SCFPOINT (p. 107) command should
be used.
Examples
SCFB 100 1010 3.5
SCFB 200 20200 4.0 4.5 4.5 4.0 4.5 4.5
Parameters
SCF
Keyword
DEFAULT
Keyword
bscfa
Default brace side SCF for axial force (Real).
bscfip
Default brace side SCF for in-plane bending (Real).
bscfop
Default brace side SCF for out-of-plane bending (Real).
cscfa
Default chord side SCF for axial force (Real).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
104 of ANSYS, Inc. and its subsidiaries and affiliates.
SCF Definition
cscfip
Default chord side SCF for in-plane bending (Real).
cscfop
Default chord side SCF for out-of-plane bending (Real).
Notes
1. This command is compulsory and must be defined only once for each section type that is to be processed.
The SCF value(s) specified will be adopted for any braces at joints which have not had specific SCF values
defined, or where automatic SCF calculation has not been requested.
2. If only bscfa is specified then this value will be adopted for all six SCF values.
Examples
SCF TUB DEFAULT 3.5
SCF TUB DEFA 3.0 3.5 3.5 3.0 3.5 3.5
Parameters
SCFJOINT
Keyword
joint
Joint number to which the brace is connected (Integer).
brace
Brace user element number for which the SCF values are to be specified (Integer).
CHORD
Keyword to denote chord side SCF values are to be defined.
BRACE
Keyword to denote brace side SCF values are to be defined.
AUTO
Keyword to request that a computed value using the empirical formulations selected on an SCF AUTO
DEFAULT (p. 100) or SCF AUTO JOINT (p. 102) command is to be adopted.
axc
SCF for axial load, crown position (Real).
axs
SCF for axial load, saddle position (Real).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 105
FATJACK Command Reference
ipc
SCF for in-plane bending, crown position (Real).
ips
SCF for in-plane bending, saddle position (Real).
opc
SCF for out-of-plane bending, crown position (Real).
ops
SCF for out-of-plane bending, saddle position (Real).
Notes
1. If the AUTO keyword is used for any locations then a complementary SCF AUTO DEFAULT (p. 100) or SCF
AUTO JOINT (p. 102) command should be provided to define the method which is to be utilized for gener-
ating the undefined values. This is also true if the chord or brace side definitions are completely omitted.
2. The ips and opc terms are strictly not required since the associated bending stress terms at these locations
are zero. They are used, however, if inspection points are selected at positions between the saddle and
crown locations. It is recommended, therefore, that the values are set the same for the crown and saddle
locations; that is ips set to ipc and opc set to ops. See SCF Interpolation (p. 41) for details about the inter-
polation of SCF values at intermediate locations.
3. For the SCF values to be correctly applied a chord must be identified for the joint concerned. This can either
be computed by the program, or may be specified using the CHORD (p. 73) command.
Examples
SCFJ 100 1010 CHORD 3.5 3.0 4.0 4.0 3.8 3.8
SCFJ 100 1010 BRACE AUTO AUTO 4.2 4.2 4.15 4.15
Parameters
SCFMINIMUM
Keyword
scfnam
Optional alphanumeric name indicating the SCF component for which the minimum SCF value is to be
specified. Permitted names are:
BAXS
Brace side axial saddle
BAXC
Brace side axial crown
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
106 of ANSYS, Inc. and its subsidiaries and affiliates.
SCF Definition
BIPC
Brace side in-plane bending crown
BOPS
Brace side out-of-plane bending saddle
CAXS
Chord side axial saddle
CAXC
Chord side axial crown
CIPC
Chord side in-plane bending crown
COPS
Chord side out-of-plane bending saddle
scfmin
Minimum SCF (Real).
Notes
1. If scfmin is omitted then the SCF value defined will be adopted as a minimum for all SCF components
defined above.
2. The value(s) defined will only be applied to the SCF computations if they are appropriate to the methodology
adopted.
Examples
SCFM COPS 2.5
SCFM 2.0
Parameters
SCFPOINT
Keyword
joint
Joint number to which the brace is connected (Integer).
brace
Brace user element number for which the SCF values are to be specified (Integer).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 107
FATJACK Command Reference
y, z
Pair of ordinates defining a point on the beam section in local y and z directions (Real).
bscfa
Brace side SCF for axial force (Real).
bscfip
Brace side SCF for in-plane bending (Real).
bscfop
Brace side SCF for out-of-plane bending (Real).
cscfa
Chord side SCF for axial force (Real).
cscfip
Chord side SCF for in-plane bending (Real).
cscfop
Chord side SCF for out-of-plane bending (Real).
Notes
1. If only bscfa is specified, this value will be adopted for all six SCF values.
2. If SCFPOINT is used for a brace, results will only be computed at those inspection points explicitly defined
by the ordinates provided in the SCFPOINT commands. Any INSPECTION (p. 87) commands referring to
this brace end will be ignored. This implies that the SCF values at ALL inspection points need to be provided.
Where SCF values are constant around the section, use should be made of the SCFBRACE (p. 103) command.
3. For any given brace, SCFPOINT and SCFBRACE (p. 103) are mutually exclusive and cannot be used together
in the same run of FATJACK.
Examples
SCFP 1100 110010 0.0 0.85 3.5 5.0 5.0 3.5 5.0 5.0
SCFPOINT 85 1185 0.65 0.50 4.5
4.33. SECONDARY
The SECONDARY command is used to specify that certain elements are to be classified as secondary
members and omitted from the fatigue computations.
Parameters
SECONDARY
Keyword
ELEMENT
Keyword to denote selection by element number.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
108 of ANSYS, Inc. and its subsidiaries and affiliates.
SIGM
GROUP
Keyword to denote selection by element group number.
PROPERTY
Keyword to denote selection by geometric property number.
list
List of user element, group or geometric property numbers to which this data is to be assigned (Integer).
The list may include the keyword TO but not ALL.
Notes
1. Elements defined as secondary will not have fatigue calculations undertaken. Their effect will also be ignored
in joint classification for the purposes of SCF calculations and will not be included in influence coefficient
calculations.
Examples
SECO ELEM 100 TO 110
SECO GROUP 999
4.34. SIGM
The SIGM command is required when stress range versus occurrence information has been requested
(using PRINT OCUR/OCRT/OCRW (p. 95) commands) and provides the additional information necessary
to generate the required table.
Parameters
SIGM
Keyword
peak
Peak stress range required (Real).
nint
Number of intervals to sample stress range (Integer).
Notes
1. This command is compulsory if PRINT OCUR/OCRT/OCRW (p. 95) has been requested.
2. Use of the PRINT OCUR/OCRT/OCRW (p. 95) commands requires that intervals of stress range are defined
over which the spectral information may be integrated to produce occurrence data for that range. The in-
terval of stress range is computed by dividing the peak value by the number of sampling intervals. The
mid value for each interval is then used as a reference value for that interval.
Examples
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 109
FATJACK Command Reference
Or graphically:
4.35. S-N
The S-N command assigns S-N curves (user or predefined) to brace elements to be analyzed.
Parameters
S-N
Keyword
name
Name of S-N curve to be assigned (Alphanumeric). This may either reference a standard S-N design curve
or a user defined curve (using the CURVE (p. 75) command).
END1, END2
Optional keywords to denote that the S-N curve is to be assigned to only one end of the element(s).
ELEMENT
Keyword to denote selection by element number.
GROUP
Keyword to denote selection by element group number.
list
List of elements or groups to which the S-N data is to be associated. (Integer.) Keywords ALL and TO may
be used to generate the list.
Notes
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
110 of ANSYS, Inc. and its subsidiaries and affiliates.
SPECTRUM
2. If END1/END2 is omitted the curve is assigned to both ends of the brace element(s).
Examples
S-N APX ELEM 1000 TO 5000
4.36. SPECTRUM
The SPECTRUM command defines the wave spectrum probability information. The wave spectra are
assigned to a transfer function number which relates analyzed waves to a spectra by way of the
TRANSFER (p. 119) command. The sea state spectra may be supplied using predefined spectra or as
user defined ordinates on the wave energy spectrum diagram.
Parameters
SPECTRUM
Keyword.
itrans
Transfer function number (Integer).
SCTW
Keyword indicating Scott-Wiegel spectrum.
JONS
Keyword indicating JONSWAP spectrum (See Ref. 6 (p. 127)).
PMOS
Keyword indicating Pierson-Moskowitz spectrum (See Ref. 5 (p. 127)).
OCHI
Keyword indicating Ochi-Hubble spectrum (See Ref. 7 (p. 127)).
UDEF
Keyword indicating user defined spectrum.
height
Significant wave height (Real).
period
Zero crossing period (Real).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 111
FATJACK Command Reference
prob
Probability (Real).
c1, c2
Constants used in defining Scott-Wiegel spectrum (Real).
hs1
Swell component significant wave height for Ochi-Hubble spectrum.
tp1
Swell component wave peak period for Ochi-Hubble spectrum.
peak1
Peakedness for swell component for Ochi-Hubble spectrum.
hs2
Wave component significant wave height for Ochi-Hubble spectrum.
tp2
Wave component wave peak period for Ochi-Hubble spectrum.
peak2
Peakedness for wave component for Ochi-Hubble spectrum.
strord
Stress direct spectral ordinate (input in the same order as the waves in the transfer function) (Real).
Notes
1. The units in which the probability is input (for example, occurrences per year, percentages, etc.) is imma-
terial providing it is consistent for all the spectral data defined. The program computes a true probability
for each sea-state by dividing each input probability by the sum of all the probabilities.
2. Only one of SCTW, JONS, PMOS, OCHI or UDEF may be used in any one transfer function.
3. The Ochi-Hubble wave spectrum is bimodall; that is, it includes a swell and wave component.
4. For user defined spectra the frequency abscissae are extracted from the wave data defined for the transfer
function. The order of the stress ordinate data should be in increasing frequency of the wave data assigned
to this transfer function, including any additional frequencies defined.
Examples
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
112 of ANSYS, Inc. and its subsidiaries and affiliates.
SPREADING
4.37. SPREADING
The SPREADING command requests that wave spreading should be applied.
Parameters
SPREADING
Keyword
power
Power of wave spreading function. If omitted, see notes for default values.
MITS
Requests Mitsuyasu spreading method. See Note 3(a).
MMIT
Requests modified Mitsuyasu spreading method. See Note 3(b).
GODA
Requests Goda spreading method. See Note 3(c).
Notes
1. The command is only valid for spectral analysis. If the command is omitted, no wave spreading calculations
will be carried out.
3. Wave spreading calculations may be undertaken by any one of the three methods described below. If
SPREADING is supplied but no method is selected, MITS is used by default. Note that in all cases the cal-
culations are carried out on the stress transfer function squared.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 113
FATJACK Command Reference
If MITS is requested then the Mitsuyasu wave spreading function is utilized, defined by:
where:
If MMIT is requested then wave spreading calculations will be carried out using the modified Mitsuyasu
formula (based upon the complete wave environment) which is defined by:
where:
If GODA is requested then wave spreading calculations will be carried out using the Goda formula
which is defined by:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
114 of ANSYS, Inc. and its subsidiaries and affiliates.
STOP
where:
r is the equation
where:
For all three methods is computed by the program by computing the angle between adjacent ana-
lysis waves. For example, for an analysis with wave directions in 45 increments, will be 0.79 radians
and, for the default spreading, nw will be 5(-/2 <= <= /2). For Goda and Mitsuyasu nw will be 8(-
<= <= ).
4.38. STOP
The STOP command is needed to signify the end of the data.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 115
FATJACK Command Reference
Parameters
STOP: Keyword.
4.39. STRUCTURE
The STRUCTURE command is used to define the name of an existing structure within the current project
which is to be processed in this run.
The STRUCTURE command is a preliminary command, and should only appear at the head of the
FATJACK data set.
Parameters
STRUCTURE
Keyword
sname
Structure name identifying which existing structure is to be accessed from the current project, see PRO-
JECT (p. 96) command (Alphanumeric, 4 characters, the first character must be alphabetic).
Usage
Compulsory.
Notes
Examples
STRUCTURE JACK
4.40. SYSTEM
The SYSTEM command is used to define the amount of memory used for data by this run.
The SYST command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
116 of ANSYS, Inc. and its subsidiaries and affiliates.
THICKNESS
Parameters
SYSTEM
Keyword
DATA AREA
Keywords
memory
Amount of memory (in 4 byte words) to be used by this run. Typical values are between 30000 and 1000000.
If the SYSTEM command is omitted, a default value of 1000000 is used. (Integer)
Usage
Optional.
Examples
SYSTEM DATA AREA 80000
4.41. TEXT
The TEXT command is used to define a line of text to be printed once only at the beginning of the
output. Several TEXT lines may be defined to give a fuller description of the current analysis on the
printed output.
The TEXT command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Parameters
TEXT
Keyword
text
This line of text will be printed once, at the beginning of the output (Alphanumeric, up to 75 characters).
Usage Optional.
Examples
TEXT THIS EXAMPLE OF THE
TEXT TEXT COMMAND IS SPREAD
TEXT OVER THREE LINES
4.42. THICKNESS
The THICKNESS command is used to request modification of the S-N curves to account for varying
plate thickness. S-N curves are generally specified for material thicknesses up to a given base value,
above this value the fatigue strength decreases with increasing thickness for a given level of stress
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 117
FATJACK Command Reference
range. For built in S-N curves the base thickness is normally predefined (see below). For user defined
curves the base value must be supplied on the CURVE (p. 75) command.
Parameters
THICKNESS
Keyword
power
Power to be used in the thickness correction. If not defined the value defaults to 0.3 (in accordance with
the current Health and Safety Executive Guidance Notes).
Notes
1. This command may be defined only once. If omitted then no thickness correction will be undertaken.
2. The following base thicknesses are used for the built in S-N curves:
Curve tb
DET 32 mm
DEF2 22 mm
APX 25 mm
APXD 16 mm
DOT N/A
If the DOT S-N curve is being used, a base thickness must be supplied as part of the S-N data.
3. The correction has the effect of multiplying the stress range at an inspection point by the factor:
For all curve types except DET, t is set to be at least tb; that is, no reduction can occur. For the T
curve, t is set to be at least 22 mm; that is, a beneficial reduction is achieved for thicknesses between
22 and 32 mm.
Examples
THICK
THICK 0.25
4.43. TITLE
The TITLE command is used to define a title for this run.
The TITLE command is a preliminary command, and should only appear at the head of the FATJACK
data set.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
118 of ANSYS, Inc. and its subsidiaries and affiliates.
TYPE
Parameters
TITLE
Keyword
title
This line of text will be printed out at the top of each page of FATJACK output (Alphanumeric, up to 74
characters).
Usage
Recommended.
Examples
TITLE THIS IS AN EXAMPLE OF A TITLE LINE
4.44. TRANSFER
The TRANSFER command defines the constituent base wave cases for a given transfer function.
Parameters
TRANSFER
Keyword
itrans
Transfer function number (Integer).
case
Base wave case number for this transfer function. (Integer).
factor
Multiplying factor (dynamic amplification factor) to be applied to this base case (Real).
Notes
1. If additional frequencies are defined (using the FREQUENCY (p. 83) command) then these are automatically
included in the associated transfer function.
2. The command may be repeated as many times as is required to fully define the transfer function.
Examples
TRAN 5 10 1.09 11 1.12
4.45. TYPE
The TYPE command is used to predefine specific joint configurations for a given brace member (or
members) at a joint. This command is compulsory if joints are modelled with two or three nodes. The
configurations are used for the automatic computation of stress concentration factors.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 119
FATJACK Command Reference
Parameters
TYPE
Keyword
joint
Joint number at which the joint type is being defined (Integer).
type
Joint type (Alphanumeric). Valid joint types are:
KT
brace
User element number specifying a brace which is to be assigned this configuration. For KT joints this must
also be the central brace member (Integer).
brace2
Second user element number corresponding to the second brace in a K, X or KT joint (Integer).
brace3
Third user element number corresponding to the third brace of a KT joint (Integer).
Notes
1. For simple joints, modelled with a single node, this command is optional and if omitted the joint configur-
ation is automatically computed as T, Y, K, X or KT depending upon the chord brace geometry. See Joint
Classification (p. 36) for details.
2. If influence functions are used any additional braces connected to the joint will be included unless declared
as secondary.
Examples
TYPE 100 T 1000
TYPE 250 KT 1100 1110 1120
4.46. UNITS
The UNITS command is used to define the UNITS which have been used in the previous analysis.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
120 of ANSYS, Inc. and its subsidiaries and affiliates.
UNITS
Parameters
UNITS
Keyword
unitnm
Name of unit to be utilized (see Notes).
Usage
The default units adopted for the input data will be those utilized in the original analysis and if this is
satisfactory no additional information is required in the FATJACK run.
If it is required to input any of the FATJACK data in a different system of units, this can achieved by
specifying one or more UNITS commands within the main body of the FATJACK data thus permitting
a combination of unit systems within the one data file.
Notes
1. By default, the analysis units used in the previous analysis will be used.
2. If analysis units were not defined for the previous analysis, the units used MUST be specified here. If ana-
lysis units were defined for the previous analysis, they can be reconfirmed here but cannot be changed.
3. The UNITS command may be repeated throughout the data block thus permitting the greatest flexibility
in data input.
4. Force, length and angular unit may be specified. Only those terms which are required to be modified need
to be specified, undefined terms will default to those of the analysis global units unless previously overwritten
by another UNITS command. The default angular unit is degrees for all data types.
5. Analysis units must be defined if it is intended to use the UNITS command in the main FATJACK data. Valid
unit names are as follows:
Length METRE(S) M
CENTIMETRE(S) CM
MILLIMETRE(S) MM
MICROMETRE(S) MICM
NANOMETRE(S) NANM
FOOT, FEET FT
INCH, INCHES IN
Force NEWTON(S) N
KILONEWTON(S) KN
MEGANEWTON(S) MN
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 121
FATJACK Command Reference
TONNEFORCE(S) TNEF
POUNDAL(S) PDL
POUNDFORCE LBF
KIP(S) KIP
TONFORCE(S) TONF
KGFORCE(S) KGF
Examples
4.47. WAVE
The WAVE command defines the association between the analyzed load cases and the wave information
used to generate the loads. If the wave loading was generated by WAVE, the association may be extracted
automatically.
Parameters
WAVE
Keyword.
AUTO
Keyword to denote that wave information is to be extracted from the analysis files.
case
Wave case number associated with this wave data (Integer).
height
Wave height (Real).
period
Wave Period (Real).
direction
Wave direction (Real).
NPOS
Keyword to denote that the number of wave positions associated with this wave case is to be defined.
This is required for stress history analysis only.
npos
Number of wave positions associated with this wave case (Integer).
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
122 of ANSYS, Inc. and its subsidiaries and affiliates.
YEAR
Notes
1. For wave loading generated or modified outside WAVE then the WAVE data must be supplied explicitly:
a. The WAVE commands must be specified in the order corresponding to the order of the analyzed wave
load cases.
b. The wave case numbers are independent of the load case numbers used in the analysis.
a. This command may only be used if the wave loading was generated using the WAVE program, and no
additional loading information was added prior to the analysis.
b. Loadcases will be generated sequentially from 1. For deterministic and spectral analyses there will be
one wave case for each analyzed load case pair. For stress history analysis due account will be taken of
the number of wave steps used in analyzing each wave case.
Examples
WAVE 10 12.0 10.0 180.0
WAVE 6 13.5 9.8 90.0 NPOS 8
WAVE AUTO
4.48. YEAR
The YEAR command defines the target fatigue life of the structure. Braces with fatigue lives less than
this value will be flagged as having failed.
Parameters
YEAR
Keyword
target
Target life in years (Real).
Examples
YEAR 50.0
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 123
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
124 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: FATJACK Appendices
This section discusses the following topics:
5.1. Running FATJACK
5.2. Section Profile Information
5.3. FATJACK References
where:
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 125
FATJACK Appendices
d
is the beam depth
b
is the beam width
tf
is the thickness of the top and bottom plates
tw
is the thickness of the side plates
where:
d
is the beam depth
b
is the beam width
t
is the thickness
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
126 of ANSYS, Inc. and its subsidiaries and affiliates.
FATJACK References
Dimensional Properties: Dt
where:
D
is the outer diameter
t
is the wall thickness
where:
d
is the beam depth
b
is the flange width
tf
is the flange thickness
tw
is the web thickness
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 127
FATJACK Appendices
Ref. Pierson, W.J., and Moskowitz, L., 1964, A proposed spectral form of fully
5 developed wind seas based on the similarity theory of S.A. Kitaigorodskii,
Journal of Geophysical Research, Volume69.
Ref. Hasselmann, D.W., Dunckel, M. and Ewing, J.A., 1989, Directional Wave Spectra
6 observed during JONSWAP in 1973, Journal Physical Oceanography 10.
Ref. Ochi, M.K., 1976, Proceedings of the 15th Coastal Engineering Conference,
7 ASCE.
Ref. Mitsuyasu, H. et al, 1975 Observations of the directional spectrum of ocean
8 waves using a cloverleaf buoy, Journal Physical Oceanography, Vol. 5.
Ref. Goda, Y. and Suzuki, Y., 1975, Computation of refraction and diffraction of
9 sea waves with Mitsuyasus directional spectrum, Tech. Note of Port and
Harbour Research Institute No 230.
Ref. DS449 Dansk Ingenirforening 1984, Pile-Supported Offshore Steel Structures,
10 Part 2, AnnexE.
Ref. Efthymiou, M. 1988, Development of SCF formulae and generalised influence
11 functions for use in fatigue analysis. OTJ88.
Release 17.0 - SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
128 of ANSYS, Inc. and its subsidiaries and affiliates.