WeldToolkit Documentation V212.1
WeldToolkit Documentation V212.1
WeldToolkit Documentation V212.1
DOCUMENTATION
www.edrmedeso.com
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Table of Contents
Table of Contents ................................................................................................................................ 2
Weld Toolkit toolbar ............................................................................................................................. 3
Save Weld Configuration ................................................................................................................ 4
Import Weld Configuration .............................................................................................................. 5
Optimize Bonded Contacts ............................................................................................................. 6
Create Weld Contacts..................................................................................................................... 7
Weld Contacts Match ..................................................................................................................... 8
Add Fillet Welds.............................................................................................................................. 9
Add Butt Welds ............................................................................................................................ 19
Fillet and Butt Weld Strength ................................................................................................... 20
Fillet and Butt Weld Strength Shell .......................................................................................... 45
Fillet and Butt Weld Strength Child .......................................................................................... 46
Lamellar Strength ......................................................................................................................... 47
Mesh Result ................................................................................................................................. 49
Clear selected weld result files ..................................................................................................... 50
Weld Fatigue overview ...................................................................................................................... 51
CSV Fatigue ................................................................................................................................. 57
Linearized Stress Fatigue ............................................................................................................. 58
Nominal Fatigue ........................................................................................................................... 60
Hot-Spot Fatigue .......................................................................................................................... 63
Effective Notch Fatigue................................................................................................................. 71
Comparison of fatigue methods ......................................................................................................... 73
Child Fatigue ................................................................................................................................ 74
Cumulative Damage ..................................................................................................................... 75
Weld Fatigue Result listing ................................................................................................................ 77
Validity of the fatigue results .............................................................................................................. 77
Weld Report ................................................................................................................................. 78
Open Preference .......................................................................................................................... 80
Licensing Features ....................................................................................................................... 90
Known Issues/limitations ................................................................................................................... 91
References ........................................................................................................................................ 91
-2-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
• Activate the app “Weld Fatigue Export” in the project (Included in the Weld Toolkit app download file)
and click the button “Save Fatigue Configuration” to export all existing fatigue result objects.
• From Weld Toolkit menu click “Import Weld Fatigue Configuration” and select the file
“WeldFatigue_Export.json”.
-3-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Click “Save Weld Strength Configuration” to save all or selected weld strength objects from the active analysis.
The file “WeldStrength.json” is saved in the solution folder subfolder “WeldStrength”, see example below.
If the file exists a “save as” window is opened to select file name and location to save the file.
Click “Save Weld Fatigue Configuration” to save all or selected weld fatigue objects from the active analysis.
The file “WeldFatigue.json” is saved in the solution folder subfolder “WeldFatigue”.
The exported objects are selected in the tree after the export as a confirmation.
The file format is new for 2020R1 and is based on “json”, a modern object-oriented syntax that can be edited
using a modern text editor (e.g. Visual Studio Code) and easily imported in e.g. Python.
The created file may be used as a template for automation tasks, i.e. to create the file with an external tool or
Ansys Wizard and then use “Import Weld Configuration” to create the objects in the file.
-4-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Click “Import Weld Strength Configuration” to browse for a “WeldStrength.json” configuration file to import
the objects in the active analysis. As default the file open browser starts in the solution folder subfolder
“WeldStrength”.
Click “Import Weld Fatigue Configuration” to browse for a “WeldFatigue.json” configuration file to import the
objects in the active analysis. As default the file open browser starts in the solution folder subfolder
“WeldFatigue”.
If the “Analysis” folder is selected only the fillet and butt weld objects are imported.
If the “Solution” folder is selected only the weld result objects are imported.
If an object with the same name already exists in the model tree the import of that object is skipped.
-5-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Select the “Connections” folder, “Contacts” folders or individual “Contacts” and click the button “Optimize
Bonded Contacts” to update all selected objects.
An info message will show the number of selected contacts to optimize and how many that was updated.
-6-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The “Create Weld Contacts” automation can be used to speed up model preparation when dealing with big
models with many parts and contacts. To use the weld contacts automation, follow these steps:
• Name each weld (seam) part so it contains “Weld” or “weld”. Tip: use “Multi rename” by selecting all
weld parts in the Geometry branch in the tree and press “F2” and type in the name “Weld”.
• Click the “Create Weld Contacts” button. This will create a “Weld Contacts” folder in the Connections
folder and create face contacts with correct settings(*) for use with the Fillet Weld Strength result.
• Delete any existing duplicate weld contacts in other contacts folders.
Notes: Any weld contact object may be deleted or re-created as you like or moved to other contact folders.
To use a specified “Auto Detection Tolerance Value” first create a “Weld Contacts” connection folder and set
the tolerance value and then click the “Create Weld Contacts” button.
Naming a “non-weld seam” part e.g. “Flange” with “Weld_Flange” will try to create contacts for that part.
-7-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
For tetrahedron meshed parts the weld contact match can be used to create a “Weld Contacts Match” folder
in Mesh Edit and create corresponding mesh imprint for the weld contacts.
This feature is useful for improved contact results when the element size difference between the parts is large
or when fatigue results in the base material at the weld toe is needed. To use the weld contacts match
automation first use the “Create Weld Contacts” and then follow these steps:
• Click the “Weld Contacts Match” button. This will create a “Weld Contacts Match” folder in the Mesh
Edit folder and create contacts match for each weld contact.
• If needed adjust the “Tolerance Type” and “Tolerance Value” to obtain a good result.
• Delete any existing duplicate contact match in other contact match folders.
Note: Any contact match object may be deleted or re-created as you like or moved to other contact match
folders.
Do not also use a “Node Merge Group” as this is not compatible with “Weld Strength”. Multi-body and node
merge can be used separately, see section “Comparison weld mesh methods”.
(*) Only contacts with “weld” in the name will be included in the contacts match.
-8-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
• Weld Section: Select edges of a solid model along the weld line. This is the location where the weld root is placed.
The edge cannot be a shared edge in a multi-body part. Also make sure that there are no bonded or no separation
contacts defined between the solid parts (from “Auto Detection”).
• Reference Face: Select a face connected to each weld section edge. If selecting additional faces these are used as
target faces only and plotted in turquoise color. See “Notes on Reference Face” below for examples.
• Weld Geometry:
Type: [Single sided/Single sided intermittent] Type of fillet weld. If “Intermittent” additional properties marked in
yellow must be defined, see “Notes on Weld Geometry” below.
Throat thickness: Weld throat thickness (default 3 mm, max 99 mm see preference file).
Free end offset: Offset of start and end for open weld seams (default 0.0 mm). (See preference file)
Min weld angle: Limit angle when creating weld elements (default 60 deg). (See preference file)
Max weld angle: Limit angle when creating weld elements (default 120 deg). (See preference file)
Section Length: Read only property of total section length, Lsection, used to help decide the weld fraction.
Weld fraction: Ratio of total weld length and total section length, Lweld/Lsection
Number of Welds: Total number of weld segments for the selected set of weld sections.
Weld Length: Individual weld segment length.
Weld Spacing: Length between each weld segment.
Throat elements: Number of elements (1-4) over throat thickness (default 3). (See preference file).
Aspect Ratio: Weld elements aspect ratio (default 2). (See preference file)
Element Order: Linear or Quadratic weld elements (default Linear).
Material: Material for weld (from Engineering Data or app default materials)
Nonlinear Effects: Use plasticity models defined in the selected material (BISO, MISO, BKIN, MKIN)
Weld annotation: Read only property for use with “Graphical Annotations”
Total Weld Length: Read only property of total weld length, Lweld, to help estimate welding time and cost.
Total Weld Mass: Read only property of total weld mass to help estimate weld material cost.
Export Weld Line: [None/SCDM Point curve (text)/DM 3D curve (text)] Export file format for weld line in Space Claim
Direct Modeler or Design Modeler format.
-9-
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Notes on Reference Face: The weld geometry will follow Planar or Curved geometry. The weld Angle is derived
from the angle between the Reference face and the opposite face connected to the Weld section edge.
The parameters weldElementMinAngle(*) (default 60 deg) and weldElementMaxAngle(*) (default 120 deg) will
control if a weld can be placed. In the picture below only parts of the full edge length fulfil the angle criteria.
An error message is shown if no weld elements are created for a group of edges.
The Target face is automatically detected from solid element nodes within a bounding box with padding size
Gapmax around the weld contact face nodes. A small Gap between the parts is also allowed as the weld mesh is
morphed onto the target faces using the command “cncheck,morph” [1]. The maximum gap size, Gapmax, is
defined as a fraction (default 50%) of the Throat thickness;
“Gapmax = weldElementGapRatio*ThroatThickness” (*). This value is also used as the pinball radius, “PINB”, for
the weld contact.
The reference face for one section edge cannot be the “target” face for another section edge in the case of
defining multiple weld chains in the same weld object. Separate the edge chains so they do not belong to parts
for the “target” face. Defining welds for multiple flange parts to one common target face in one Fillet Weld
object is OK.
If additional faces not connected to any section edge are selected these are used as target face only. For
complex thin-walled geometry this is recommended to avoid that contacts are created on both sides of the
target plate.
Partial penetration welds can be defined by using the “chamfer” face as the reference face.
The Throat thickness is always defined from the section edge out to the free weld surface for each node along
the weld line, see example of pipe connection in the section “Visualization of weld mesh and weld stress
results”.
Table 2. Example of Weld section, Reference Face and Target Face
Planar geometry Curved geometry Partial penetration
Throat thickness
Gap
Angle
Gap
Angle Angle
- 10 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Debugging tips
If the green lines that defines the weld geometry is not displayed at the expected location the surface
geometry quality may be poor.
Solution: Try to simplify the geometry in Space Claim, e.g. replace a face with a new planar or cylindrical face.
If the lines are “translated” or “scaled” the saved geometry information has been corrupted.
Solution: Open Space Claim and “cut and paste everything” (CTRL+A, CTRL+X, CTRL+V) and then close Space
Claim. This trick forces a geometry update that usually will resolve any graphical issues.
There is a debug option in the preference file that will plot the weld nodes coordinate system when evaluating
a weld result. The triad has the same orientation as the “Weld Csys” plotted at the beginning of each edge.
When changing between evaluated results the node triads will not be visible anymore.
In case the model does not solve you may open the model in MAPDL to review the mesh before solving by
adding a MAPDL system to the “Setup” component of your analysis and the select “Edit in Mechanical APDL…”.
This allows you to inspect the weld mesh and element quality etc. prior to solving. There is a component
(Named Selection) named “FILLETWELDGROUPELEM” that contains all fillet welds created by the app.
- 11 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
If you have planar geometry and no gaps or for some other reason don’t want to morph the weld contact
nodes to the target face you may tag the weld object with the tag “FilletWeldNoMorph” to exclude that weld
object from morphing. The default value for the new welds is defined in the preference file. (The tag is
automatically added to the project when adding a Fillet Welds Group.)
- 12 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
For a weld seam with free ends (an open chain) the start and end of the weld can be offset from the start and
end vertex using the property “Free end offset”. The default value is defined by the parameter
weldElementEndOffset (default 0.0 m) in the preference file.
If the angle between the tangents of two connected sections or individual weld segments is greater than 45
degrees the weld seam is split to avoid warped elements, see the weld corners in the picture below.
End Offset
Sharp corner
The weld seam is also checked for negative volume elements that may occur if the throat thickness is greater
than the section edge curvature at an inner radius.
Combining “Add fillet weld” with standard contacts between the connected parts may cause contact
constraint forces resulting in un-realistic weld results. For the same reason creating fillet welds on both the
inside and outside corner is not recommended.
- 13 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Also note that the minimum “Weld Length” and the maximum “Weld Spacing” are defined in the preference
file, see section “Open Preferences”.
If using Design Explorer to analyze different weld parameters use “Throat thickness”, “Number of Welds” and
“Weld Length” as input parameters and “Total Weld Length”, “Section Length” and “Total Weld Mass” as
output parameters. The resulting weld fraction can be derived as a new output parameter using an expression
for “Total Weld Length” divided by “Section Length”; “P5/P6”.
- 14 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The weld stress results can be plotted for the entire model or for specific material numbers using the Scoping
Method: “Result File Item”. To plot only solid elements use: “Item Type: Element Name IDs” and “IDs:
185,186,187,190”. Note: Use “Fillet Weld Strength” to post process specific weld code results.
- 15 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
In case of complex geometry with curvature and gaps the weld contact status can be verified by a “Rst Contact
Status”. The contact status values have the following meaning;
0: Open far, 1: Open near, 2: Closed sliding, 3: Closed sticking (Bonded).
- 16 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The fillet weld mesh (Solid185/Solid186) and the needed weld contacts are created during solution. By setting
the option “writeFilletWeldCdb = True” in the preference file all fillet weld mesh from the “Fillet Welds Group”
are exported to the ANSYS cdb file “FilletWeldGroup.cdb” in the “Solver Files Directory”. Read the cdb file in
an “External Model” and link the “Setup” cell to the “Model” cell of a “Mechanical Model” and finally link it to
a “Geometry” system to export to a target geometry format.
Individual weld lines can also be imported into Space Claim or Design Modeler. See the “Export Weld Line”
option for the weld objects.
- 17 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Model assembly
The Mechanical model of the welds can also be used in a model assembly with the original geometry for other
analyses, e.g. “Transient Thermal”.
Note: The “Fillet Weld” object can be defined in thermal analysis prior to the structural analysis without using
model assembly, see the analysis system A & B in “WeldToolkit-StrengthDemos_V212.1.wbpz” .
If the Engineering Data material name already exists in the weld material list you get the option to update the
material with the new properties defined in Engineering Data.
- 18 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 19 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Inputs
• Weld Section: Select edges of a shell or solid model along the weld seam line. This is the location where
the results are plotted. The order the edges are selected are used to define the path direction.
The edge can be a shared edge in a shell or a multi-body part or a free edge from a contact face of a weld.
Edge to surface contacts as well as mesh connections are also allowed. For edge to edge contact the Weld
Section must use the Contact side and not Target side. See Table 3 on following page for selection logic.
• Reference Face: For each weld section select a face connected to the weld section edge. The face is used
to create a local cartesian or cylindrical coordinate system for the weld section extraction, see Table 3 of
pictures for valid selections.
The reference face should be selected from the part that is welded, meaning that the section forces are
extracted from the part the reference face belongs to.
- 20 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
• Weld Geometry
Geometry select: [Manual select/Manual select with offset/Fillet Welds_IdXYZ] Use “Manual select *” to
post process welds defined by multi-body, node merge or contacts. Welds defined with the “Add
Fillet/Buttt Welds” must be selected from this list otherwise the weld results are not identified. Selecting
an existing weld in the list will select Weld Section, Reference Face, Type, Min Thickness, Free end offset
and Weld fraction automatically. You may edit and reorder or reduce the number of Weld Section edges.
Type: [Single sided/Double sided/Single sided intermittent/Double sided intermittent] Type of fillet weld,
see Table 3 below. The butt weld result object will only display “Butt weld” (read only).
Weld side: [Top/Bottom/Top&Bottom] Position the weld section in relation to the reference face and
display results from this side.
Min thickness: Weld throat thickness, default amin = 3 mm. If set to 0 program will calculate the needed
minimum thickness (and set the start thickness to “minWeldSize” defined in the preference file).
Calculate Min Thickness: [No/Yes]. Flag to indicate if weld thickness will be calculated. Can be used to
override the thickness defined for an “Add Fillet Weld” that is shown as a read only property.
Free end offset: Inactive weld length on an open weld chain. Used to calculate total effective weld length.
Weld fraction: For intermittent weld only. Ratio of Total Weld Length to Total Section Length, Lweld/Lsection
Total Weld Length: Read only property of weld length, Lweld, to help estimate welding time and cost.
• Weld Evaluation
Weld code: [Eurocode 3/Eurocode 3 Simplified/AWS Groove */AWS Fillet].
Weld code to use, see section “Weld codes”. (Custom weld codes can be added by the user, see section
“Custom weld Codes”)
Material: [S235/S275/S355/S420/S460/Unknown] Joint material grade to decide Correlation factor w,
safety factor M2 and Weld Strength Fu. (Material grades are defined in the preference file).
Correlation factor Bw: Correlation factor w. Default = 0.8.
Safety factor M2: Partial safety factor M2. Default = 1.25.
Weld strength Fu: Minimum of joint material ultimate limit, fu. Default = 360 MPa.
• Weld result
Result Item: [Section Length/Min thickness/Wuf/Seqv/Snormal/Tparallel/Tnormal/Ttotal/Sparallel
/Sbending/Sstruct/Bending ratio/FX/FY/FZ/Fsum/MY/MYutil/Force angle/Weld angle/Result location]
Result item to display. See section “Result listing” for available items and description.
Result averaging: [Floating/Segment/Section/Group] See section “Result averaging”.
Floating Factor: Floating factor from selected “Weld code”. Typing “0” will reset to default value.
Segment Length: Segment length. Default: L = floatingFact*amin adjusted to fit “Total Weld Length”.
Result location: Set the location of weld throat evaluation [Auto,0.5] Auto: Use the most critical of the
defined locations defined in the weld code. 0: At the reference face, 0.5 throat section, 1: target face.
Calculate Time History: [No/Yes] Evaluate all results steps. Set to No to speed up post processing.
Display Graph: [No/Yes] If “Calc Time History=No” the path result is displayed in the “Graph” window.
Scale Factor Value: Scale factor to apply to the calculated loads. In a Random Vibration analysis this sets
the probability of the results (1:68.269%, 2:95.45%, 3:99.73%).
• Definition
By: [Time/Result Set/Maximum Over Time/Time Of Maximum] Mechanical standard property for
selecting display time, result set or maximum over time.
- 21 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Table 3. Valid weld geometries and the Type, Weld section and Reference Face
Shell model Solid model Solid model Solid model
(no weld part) (no weld part) (weld part) (Add Fillet/Butt Weld)
1
Type: Single sided Type: Single sided Type: Single sided Type: Single sided
2
Type: Double sided Type: Double sided Type: Single sided Type: Single sided
3
Type: Single sided Type: Single sided Type: Single sided Type: Single sided
4
Type: Single sided Type: Single sided Type: Single sided Type: Single sided
5
Type: Single/Double sided Type: Single/Double sided Type: Single sided Type: Single sided
6
Type: Single sided Type: Single sided Type: Single sided Type: Single sided
7
Type: V-Butt weld
Type: Butt weld Type: Butt weld Type: Butt weld Type: Bevel Butt weld
Notes on Weld Section: One special case is the double-sided solid model without weld elements (row 2 & 5,
2nd column in Table 3). In this case you may select both edges (one from each side) connected to the same
contact or shared nodes to visualize the results in all places where there is a weld. You must still use Type:
“Double Sided” since the weld forces are evaluated from one common contact or shared face.
Notes on Type: The “Type” relates to the number of welds that are connected to the “Weld section” selection
and not direct to the weld joint type whether it is a physical single or double-sided weld joint. This simply sets
the scale factor on the forces to correctly evaluate the weld stress. A butt weld is always treated as a “single
sided” weld.
- 22 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
a1
t
b = MY/Wa1
MY = FZ*dM
dM = 0.5*(t + a1sin(1))
In a double-sided weld without weld elements (shell or solid) a bending moment, MY, is balanced by an
internal force pair, FZM, in the throat section. This force is used to calculate the bending stress, b, (normal to
the section). This force is also added to the existing FZ force and contributes therefore to the normal and shear
stress evaluation to handle bending effects correct.
MY
t
a1
b = FZM*sin(1)/a1
Note: For a solid weld or “Add fillet weld” the offset effect is included automatically from the reaction forces
and moments in the elements of the weld section.
- 23 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 24 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 25 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Weld Codes
Eurocode 3
The weld analysis is based on section “4.5.3.2 Directional method” in Eurocode 3 [2].
A uniform distribution of stress is assumed on the throat section of the weld, leading to the normal stresses
and shear stresses shown below.
= normal stress perpendicular to weld throat plane
⊥ ⊥
= normal stress parallel to weld axis
//
= shear stress in plane, perpendicular to weld axis
⊥
= shear stress in plane, parallel to weld axis
//
// ⊥
The weld seam is assumed to have sufficient strength if both conditions below are fulfilled:
0.9 f u
Eqv = ⊥2 + 3 ( ⊥2 + //2 )
fu
= f uEqv and ⊥ = fu⊥
w M 2 M2
fu Nominal ultimate tensile strength
w Correlation factor for material according to table 4.1 in Eurocode 3
M2 Partial safety factor for joints. M2= 1.25 for welded connections
Table 4.1 Eurocode 3 [2]. Data for fu valid for thickness < 40 mm.
Steel Grade Correlation factor W fu [MPa]
S235 0.80 360
S275 0.85 410
S355 0.90 470
S420 1.00 520
S460 1.00 540
Eurocode 3 Simplified
The method based on section “4.5.3.3 Simplified method for design resistance of fillet weld” is also
implemented. This method is a “floating average” method where the local stress intensity, independent of the
orientation, is compared with the shear strength resistance. The stress for each node along the weld is the
average from a section length of 2*a, where a = min throat thickness. Note: the “Result averaging” must be set
to “Floating” for this to work.
fu / 3
Eqv = ⊥2 + ⊥2 + //2 = f vwd
w M 2
- 26 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
AWS
The method is based on AWS D1.1/AISC 360-16 Table J2.5 [5] and defines the weld capacity for butt (groove)
welds and fillet welds differently. The “Equivalent stress”, Eqv, is used to define the total shear stress, , in the
equations in the preference file. The base metal shear strength is assumed to be 57.7% of the ultimate
strength.
The total “equivalent” stress is calculated as the vector sum of the weld section stresses.
User
In the Weld Strength preference file “weldStrengthPref.py” in the installation folder there is an example for
defining a “User” weld code. In this example the equivalent weld stress is only compared with the nominal
weld strength, fu, divided by M2.
Eqv = ⊥2 + 3 ( ⊥2 + //2 )
fu
= f uEqv
M2
Additional weld codes based on component and structural stresses can be defined, see section “Custom weld
codes” for more information.
Additional post-processing.
The weld results for each result object are automatically exported to a csv file. Combining the csv files for
different load steps allows for stress range and fatigue life calculation outside of the app, e.g. in “Microsoft
Excel”.
Using the free app “CSV Plot” the strength or fatigue results can be plotted back on the geometry for easy to
view post processing. See the section “External post processing” for more details.
The csv file may also be used with the feature “CSV fatigue” where an imported stress list can be evaluated
against a selected S-N curve.
- 27 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Weld Result
General
The default result item is the “Weld utilization factor”, Wuf, along the weld, i.e. how much of the weld capacity
that is used;
Eqv ⊥
Wuf = max , (Eurocode 3)
uEqv f u ⊥
f
If the Calculate Min Thickness is set to “Yes” (or Min thickness is set to 0) then the minimum allowed thickness
along the weld is calculated. The initial thickness is set to 3 mm and stepwise increased by 1 mm until Wuf ≤
1.0. The initial thickness and increment can be edited in the preference file, see the section: “General
Preferences”. The min and max values can be assigned as an output parameter for parameter studies.
There is no check of the plate thickness and a recommended maximum weld thickness.
The maximum allowed calculated weld thickness is limited to 99 mm. This may be edited in the preference file,
see the section: “General Preferences”. If the calculated weld thickness is larger the thickness is set to 999 mm
indicating an un-converged weld size calculation. This is an indication of a poor design in relation to the loads.
If the weld thickness is much larger than the plate thickness the failure will occur in the plate instead, hence a
poor design.
It is recommended to update the model with respect to the proposed weld throat thickness since the stiffness
change may influence the force distribution and hence the weld evaluation as well as the nodal average that is
based on the weld thickness. If using the “Add Fillet Weld” updating the model is quick and easy.
Bending moment check
Bending moment parallel to the weld is not considered in the evaluation of the weld stress according to
Eurocode 3 or AWS since the bending average stress is zero in straight sections of butt weld (A) or single sided
fillet welds (B). For a shell or solid double-sided fillet weld without weld elements (C) the bending moment will
result in a force pair with average weld forces that is non-zero.
A check is implemented to calculate the “Moment utilization” (MY util) that is the ratio of bending moment
(MY (parallel)) and maximum plastic moment capacity, Mplast.
If the section moment is higher than Mplast a warning message is issued, and the section Id and time step is
listed in the messages window.
(A) (B) Mplast (C) Mplast
a a
t
= fu
Mplast a F
F
- 28 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Result averaging
Eurocode 3 specifies that a load carrying weld must not be shorter than the maximum of 30 mm or 6 times the
throat thickness. There is also a limit on how long a weld can be to consider a uniform stress distribution. Since
FE is used that will account for a non-uniform stress distribution the following modified approach is used when
deriving the section forces and calculating the utilization factor in order to be conservative especially regarding
long welds.
All results can be viewed with different averaging methods; “Floating”, “Segment”, “Section” or “Group”.
Section average displays a constant result value for each section edge based on the total section forces. This
can be very un-conservative for long welds as well as over conservative for short edge segments in a long
continuous weld.
Floating average sums the section forces along the section edges based on a centered selection around each
node with the length of 6*a, where a = min throat thickness.
For a short single weld (length 6*a) this method will give a constant result over the weld.
For a longer weld the method will typically “highlight” the ends of the weld or inner points depending on how
the load is applied. At a free end the effective average length will be “3*a” since a centered selection is used.
The floating length factor can be modified for each weld code in the preference file “weldStrengthPref.py” in
the installation folder, see the section “General Preferences” for more information. The default value for
“Floating factor” is displayed in the result details and can easily be edited for the selected result.
Segment average splits the edge chain in virtual segments of the length “Floating length” and displays a
constant value based on the summed forces from each segment. The “Segment length” can easily be edited
and is automatically adjusted to fit the length of the weld. The initial length is based on the default “Floating
factor”. There is an option “condensedSegmentCSV” in the preference file that if set to “True” will only list one
node result per segment in the result csv file.
Group average displays a constant result value for all connected section edges based on the weighted sum of
the individual section results in relation to the total effective group length including “Free end offset”. This is
useful for plotting the total force intensity to verify with applied forces and moments etc. Group average may
be misleading in the case of a closed weld loop. A global shear force (F) will result in zero parallel group force
(Y) since the local coordinates X and Y are following the weld line and the force on one side will cancel out the
force on the other side. The group forces or weld stresses may cancel out but the weld utilization, Wuf, is not
influenced since it is based on the sum of the individual edge results and not the global forces.
X
Y
Y F
X
X
Y
Y
X
Note:
Each edge section in the weld result is grouped to find adjacent edges so that the floating, segment and group
average will correctly evaluate over edge ends and short edge segments. If only selecting one or a few of the
edges in a weld the floating, segment and group average are based on those edges only ignoring that the weld
may be longer.
- 29 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
A comparison between “Floating” and “Segment” path result is shown in the figures below.
An individual graph can be displayed by setting “Display Graph=Yes”.
1.6
Floating 6a
1.4 Segment 6a
1
Wuf [-]
0.8
0.6
0.4
0.2
0
0.00 0.05 0.10 0.15 0.20 0.25 0.30 0.35 0.40
Section position (Y) [m]
Note: If using “condensedSegmentCSV =True” the graph will not display correct if using segment average.
- 30 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The sign of the section forces and stresses are based on reactions in the shown coordinate systems below.
The local stresses are derived using the following equations:
n1
If “Double sided” weld and “Weld side” set to ”Top/Bottom” the other side is also evaluated.
2 = k1(180-)
= (−)− = (180-)(0.5-k1)
a2 = amin/cos2
n2 = loadFact(FZcos2 - FXsin2)/a2
n2 = loadFact(-FXcos2 - FZsin2)/a2
FZ
ez
n1
n2
a1
2
FX
a2 amin ex
n1
-FX 2
n2
- 31 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Structural stress
One limitation with Eurocode 3 is that pure bending stress over the throat section is neglected in the
evaluation. Many other static and fatigue evaluation methods use structural stress; s = n + b
In addition to the result item bending moment intensity “MY (parallel)” and the normal stress, n, the bending
stress, b, structural stress, s, and bending ratio, Br (Br = b /s) are available.
b = MY/W, where W = La2/6, L: length of the weld section, a: height of weld section
s = abs(n) + abs(b) The structural stress is saved as the absolute maximum of the stress.
Depending on selected “Result location” the value of bending stress will vary since the throat thickness, a, is a
function of weld angle and thus also W.
Typically, the bending stress in the throat is a factor of two compared to the bending stress at the leg section.
Sb amin = 6MY/(Lamin2), Sb leg = 6MY/(L(2amin)2) = 6MY/(2Lamin2)
Sb amin/Sb leg = (6MY/(Lamin2))/(6MY/(2Lamin2)) = 2
The bending and structural stress may be used when defining a user defined weld code, see section at the end.
To access the structural stress in the weld leg sections, k1 = 0 and k1 = 1, the weld code property “evalSect”
must be edited to include the sections to access, e.g.:
weldCodes['User'].Add('evalSect',[0.0,0.25,0.5,0.75,1.0])
In the result object set “Result Location” to 1.0 to evaluate the results at the opposing face to the reference
face. Set it to 0.5 to evaluate at the minimum throat thickness.
F
F
s
s
If the weld is a solid part, select the reference face at the same leg that you want to evaluate the structural
stress since the moment is extracted from the weld leg at the reference face. For the “Add fillet weld” the
moment is always extracted at the mid throat section.
- 32 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Result listing
For each weld result object, a csv file is created for each result set (or time) listing all results for all nodes
based on the selected type, min thickness, weld code, material, average etc. This file can be used for plotting
path results in e.g. Microsoft Excel or perform load step combinations or other post processing tasks. The
results can then be plotted back using the app “CSV Plot” (Free on ANSYS app store).
The weld stress results, e.g. the “Structural Stress” may also be post processed using the feature “CSV Fatigue”
for life evaluation using a custom S-N curve.
The results are grouped for each chain of edges and sorted with respect to the edge connectivity.
The group average is identified by Node Id = 0 and Sect Id = 0. The section average is identified by Node Id = 0.
Node Id Weld Section Node number
Group Id Weld Section Group number
Sect Id Weld Section edge “Reference Id”. (Use selection information to see the Id number(*))
Section Section path position or Weld section edge length (Node Id = 0) or group length (Sect Id = 0)
Position
Min thickness Actual or calculated min needed weld throat thickness to fulfil Wuf < 1
Wuf Weld utilization factor
Seqv Equivalent stress based on selected weld code, Eqv
Snormal Normal stress, n (or ⊥)
Tparallel Parallel shear stress, p (or )
Tnormal Normal shear stress, n (or ⊥)
Ttotal Total shear stress, t
Sparallel Parallel stress, p (or )
Sbending Bending stress, b
Sstruct Structural stress, s = abs(n) + abs(b)
Bending ratio: Bending stress ratio, Br = abs(b)/s
FX (radial): Force intensity normal or radial to the weld section reference face
FY (parall): Force intensity parallel or tangential to the weld section
FZ (axial): Force intensity perpendicular to the weld section (axial)
Fsum: Total force intensity along the weld section
MY (parallel): Moment intensity parallel to the weld section
MY util: Moment utilization; ratio of MY and maximum plastic moment capacity
Force angle Force reaction angle relative to weld section axis, (used for AWS fillet calculation)
Weld angle Average weld angle for the section,
Result location Relative location for critical section. 0: at reference face, 0.5: throat section, 1: other face
Note 1: The listing of FX, FY, FZ and Fsum is of type “Force Intensity”, i.e. [N/m]. To get the total force for a
weld multiply the force intensity by the section length (Sect L).
MY (parall) is of type “Moment intensity”, i.e. [Nm/m] = [N]. The coordinate system can be shown by tagging
the result with “AlwaysPlotWeldcsys”.
Force and moment intensity for a double-sided weld is reported per weld. The sign for stresses and forces are
defined as the reaction on the reference face part.
Z
⊥
Y
Fsum
⊥ X
- 33 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
(*)
Beta options are activated from Workbench Project page, Tools > Options…
When selecting an edge the Id number is displayed in the “Selection Information” pane.
The weld graphics is now updated and prints the Id number on the edge centroid.
- 34 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 35 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The nodal forces are saved in the global coordinate system (RSYS = 0). The reason for this is that the floating
average first sums the forces and then project onto the local coordinate system of the weld.
The nodal coordinates and forces are saved in text files in folder “WeldStrength” in the solution folder. These
files may be used for any purpose in external post processing.
The corresponding listing can be made in Mechanical by creating “User Defined Results” for the weld section
nodes with expression “ENFOX”, “ENFOY” and “ENFOZ” in the global coordinate system and export to text
files.
The local coordinate system, (DSYS), has origin at the Weld Section edge start point, Y axis along the edge, X
axis normal to the Reference Face and Z axis in-plane of the Reference Face. For cylindrical faces origin is at the
radial center point, X axis is radial pointing to the start vertex, Y axis is tangential, and Z axis is axial.
The set number, NSET, is the incremental number from all available result sets, not the load step or time.
Corresponding MAPDL command: “SET, , , , , , ,NSET”
The “edgeId” and “faceId” is the “REFERENCE_ID” found in the “Selection Information” for the edge and face.
- 36 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Verification
A number of verification examples are saved in the Workbench archive file, “WeldToolkit-
StrengthVerification_V212.1.wbpz”.
For pure shear loading all models shows good agreement with hand calculation. The shell “Offset Type” may
influence the results a bit especially for cylindrical faces.
For pure normal loading models with solid weld elements tend to give higher weld utilization due to additional
constraint forces.
Table 4. Comparison of section average weld utilization, Wuf, between hand calculation and FE-model (EC3).
LC1. Shear load LC2. Normal load
A B C D A B C D
Hand Shell Solid Solid Solid Hand Shell Solid Solid Solid
Row Joint calc (No weld) (No weld) (Weld part) (Add weld) calc (No weld) (No weld) (Weld part) (Add weld)
1 T-joint Single sided 0.65 0.65 0.65 0.65 0.65 0.53 0.53 0.53 0.53 0.55
2 T-joint Double sided 0.33 0.33 0.33 0.32 0.33 0.27 0.27 0.27 0.78 +192% 0.82 +208%
3 Lap joint 0.65 0.65 0.65 0.65 0.65 0.53 0.53 0.53 0.53 0.53
4 Cyl joint 1 1 0.78 0.78 0.79 0.78 0.75 -4% 0.45 0.51 +15% 0.48 +8% 0.52 +16% 0.56 +26%
5 Cyl joint 1 2 0.78 0.82 0.78 0.78 0.75 -4% 0.45 0.46 +4% 0.43 -4% 0.53 +18% 0.58 +30%
6 Cyl joint 2 0.84 0.84 0.84 0.83 0.84 0.47 0.64 +35% 0.69 +45% 0.71 +50% 0.72 +52%
7 Planar Butt Joint 0.65 0.65 0.65 0.65 0.65 0.52 0.52 0.52 0.52 0.52
8 Cyl Butt joint 0.78 0.78 0.83 +7% 0.77 0.90 +15% 0.45 0.44 0.44 0.41 -7% 0.48 +7%
It is worth mentioning that only in the simplest loading cases it is possible to get agreement with hand
calculation. If you have multiple welds around a bracket you cannot predict the elastic force distribution by
hand, only a possible plastic limit state distribution. Also, in case of modelled welds and combined loadings
constraint forces may occur in the welds that is not predicted by hand calculation, e.g. in a double-sided fillet
- 37 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
weld with only normal loading (C2/D2) or cylindrical joints (row 4-6) you may get high normal stress due to the
deformation of the structure.
If instead looking at the calculated force intensity in the direction of the applied load the results are perfect.
The only noticeable difference is for cylindrical welds where the weld forces acts at a different radius
compared to the Weld Section” edge. If the effective weld radius is bigger the total shear force from the
applied moment load is smaller and thus the force intensity is lower compared to the hand calculation where
the effective radius and length is taken from the inner radius of the weld (at the section edge). For the butt
weld (D8) the section edge is shorter than the length used in the hand calculation and thus the intensity is
higher.
Table 5. Comparison of section force intensity between hand calculation and FE-model (EC3).
LC1. Shear load (N/mm) LC2. Normal load (N/mm)
A B C D A B C D
Hand Shell Solid Solid Solid Hand Shell Solid Solid Solid
Row Joint calc (No weld) (No weld) (Weld part) (Add weld) calc (No weld) (No weld) (Weld part) (Add weld)
1 T-joint Single sided 543.5 543.5 543.5 538.4 543.5 543.5 543.5 543.5 536.1 553.1
2 T-joint Double sided 271.7 271.7 271.7 269.2 271.7 271.7 271.7 271.7 269.4 272.0
3 Lap joint 543.5 543.5 543.5 538.1 543.6 543.5 543.5 543.5 538.8 543.5
4 Cyl joint 1 1 649.6 650.9 660.4 645.6 625.3 -4% 454.7 454.7 442.1 450.5 454.7
5 Cyl joint 1 2 649.6 678.4 +4% 649.6 645.8 625.3 -4% 454.7 484.1 +6% 454.7 450.3 454.8
6 Cyl joint 2 694.4 693.9 694.5 691.8 694.7 694.4 663.1 -5% 695.3 690.3 695.2
7 Planar Butt Joint 543.5 543.5 543.5 536.9 543.5 543.5 543.5 543.5 538.9 543.5
8 Cyl Butt joint 649.6 648.6 691.6 642.0 745.7 +15% 454.7 454.7 451.3 430.1 -5% 496.7 +9%
The calculated utilization matches the hand calculation perfect for single sided fillet weld and butt weld. For
double sided solid weld etc. we may see similar differences as for Eurocode 3 due to constraint forces in the
model not accounted for in hand calculation.
Table 6. Comparison of section average weld utilization, Wuf, between hand calculation and FE-model (AWS).
Load angle Hand calc Shell (No weld) Solid (No weld) Solid (Weld part) Solid (Add weld)
Row Joint Phi [deg] Wuf A B C D
1 T-joint Single sided 0 1.26 1.26 1.26 1.25 1.26
1 T-joint Single sided 22.5 1.13 1.12 1.12 1.11 1.13
1 T-joint Single sided 45 0.97 0.97 0.97 0.96 0.97
1 T-joint Single sided 67.5 0.87 0.87 0.87 0.87 0.87
1 T-joint Single sided 90 0.84 0.84 0.84 0.83 0.84
7 Planar Butt-Joint 0 1.25 1.26 1.26 1.24 1.26
7 Planar Butt-Joint 90 1.18 1.18 1.18 1.17 1.18
- 38 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The test load is an axial force, FZ = 5000 N, and a bending force, FY = 1000 N. The throat thickness, a = 4 mm,
and weld length, l = 100 mm, bending leverage h = 50 mm. Bending moment, MY = FY*h = 1000*50 = 50e3
Nmm.
With solid weld the weld offset adds moment due to the plate thickness (0.5*5 mm) and weld (0.5*5/ 2).
The offset effect can also be included in models without weld by using “Manual select with offset”.
A
B
1 C
D
Table 7. Comparison of section average structural stress between hand calculation and FE-model.
Bending load, Structural Stress
A B C D
Row Joint Hand Shell Solid Solid Solid
calc (No weld) (No weld) (Weld part) (Add Weld)
1 T-joint Single sided No offset:125.7 125.7 125.7 Vert ref: 147.2 Throat elem 1: 173.4 +0.4%
With offset: 172.7 176.9 176.9 Hor ref: 198.1 Throat elem 2: 176.3 +2.1%
Avg: 172.7 Throat elem 3: 169.6 -1.8%
Throat elem 4: 170.7 -1.2%
7 Planar Butt Joint 130.0 130.0 130.0 130.0 Throat elem 1: 135.6 +4%
(Bevel) Throat elem 2: 135.6 +4%
Throat elem 3: 135.5 +4%
Throat elem 4: 135.5 +4%
7 Planar V-Butt Joint Throat elem 3: 136.0 +5%
- 39 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The shell models have the thickness offset inwards. The solid models use solid shell (SOLSH190) except for the
weld part itself. The models are created in ascending complexity/quality where model 9 is the reference model
using the “Add Fillet Weld” with 4 elements over the throat section.
9
8
7
6
5
4
3
2
1
A bending load adds shear and normal forces on the welds. The three pipes with welds (7 - 9) has slightly lower
deformation since the welds adds stiffness to the structure. The other pipes have identical deformation and
hence stiffness. A second load step adds a pure axial load to the pipes.
- 40 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The Weld Strength result shows that the pipes without welds have almost identical results and the three pipes
with welds has slightly different results.
LC 1
LC 2
Pipe 9 (4 el)
Pipe 8
- 41 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The floating average of weld utilization factor, Wuf, for each pipe is plotted in the graphs below. The
difference is discussed on the following page.
Path
0.20
Wuf 1
Wuf 2
0.15
Wuf 3
Wuf [-]
Wuf 4
Wuf 5
0.10
Wuf 6
Wuf 7
Wuf 8
0.05
Wuf 9
0.00
0.00 0.05 0.10 0.15 0.20
Path position Y [m]
0.20
Wuf 1
Wuf 2
0.15
Wuf 3
Wuf [-]
Wuf 4
Wuf 5
0.10
Wuf 6
Wuf 7
Wuf 8
0.05
Wuf 9
0.00
0.00 0.05 0.10 0.15 0.20
Path position Y [m]
The following bar plot shows the average Wuf along the weld for all models. The bending load case, LC1, has a
variation of approximately ±15%. The shell models (1-3) have lower Wuf than the solid models. The solid
models with weld elements (7-9) have slightly higher Wuf than the models without welds.
For the tension load case, LC2, the variation in Wuf is smaller ±6%. and no clear trend is visible.
- 42 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Wuf average
0.120
0.100
0.080
0.060
0.040
0.020
0.000
Wuf 1 Wuf 2 Wuf 3 Wuf 4 Wuf 5 Wuf 6 Wuf 7 Wuf 8 Wuf 9
LC1 LC2
15%
10%
5%
0%
Wuf 1 Wuf 2 Wuf 3 Wuf 4 Wuf 5 Wuf 6 Wuf 7 Wuf 8 Wuf 9
-5%
-10%
-15%
-20%
LC1 LC2
Shell models without weld elements (Pipe 1 - 3) has almost identical Wuf results independent of the joint
method but may differ depending on load case compared to the reference model. Shell models without weld
elements don’t have that much constraint forces that explains the lower Wuf in LC1 compared to the
reference model with weld elements. A solid multi-body part model with or without weld elements (Pipe 4 &
7) or a solid edge contact (Pipe 6) tends to over predict Wuf, see “Notes on bonded contact vs. multi-body” in
previous section.
The difference between Pipe 8 and Pipe 9 (reference) is that the section forces for the reference model are
extracted from the throat contact section and not the contact between the pipe and weld as for Pipe 8. Also
note that for a model with weld parts the result might differ depending on what side of the weld that is used
as the reference side. It is possible to use the planar faces of the weld in contact to the plate as well as the
faces in contact to the pipe.
- 43 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Looking at the axial force intensity (FZ) all models have very similar results.
Comparison FZ LC1
150 000
100 000
Pipe 1
50 000 Pipe 2
Pipe 3
Pipe 4
F N/m
0
0.00 0.05 0.10 0.15 0.20 Pipe 5
Pipe 6
Pipe 7
-50 000
Pipe 8
Pipe 9
-100 000
-150 000
Path position Y [m]
Comparison FZ LC2
100 000
50 000
Pipe 1
0 Pipe 2
0.00 0.05 0.10 0.15 0.20
Pipe 3
FZ [N/m]
Pipe 4
-50 000
Pipe 5
Pipe 6
Pipe 7
-100 000
Pipe 8
Pipe 9
-150 000
-200 000
Path position Y [m]
- 44 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The first difference compared to the standard Fillet and Butt Weld Strength result is that the results are
plotted on the elements attached to the weld section edge, see left part of figure below. This allows multiple
welds connected to the same edge to be evaluated at the same time. For large welded structures with many
cruciform joints all welds can then be evaluated at once since multiple reference faces can be selected for all
weld section edges.
The second difference is result averaging that has only two options “Element” and “Section”. Since element
size in large shell models is much greater than the weld throat thickness a floating or segment average does
not make sense. (The “Group” option is only meaningful if a single weld line is selected.)
Except for these two changes all other aspects of the result properties works in the same way.
A shell model may also be evaluated using the original “Weld Strength” result, see the demo “Cruciform Joint”
in “WeldToolkit-StrengthDemos_V212.1.wbpz”
- 45 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
If all result steps are evaluated from the “Parent” result (“Calculate Time History = Yes”) the child result can
evaluate any of the individual result steps or “Maximum over Time” etc.
Result averaging can be “Element/Floating/Segment” or “Section” or “Group”. If the parent result was
evaluated using “Segment” then the child will also display average as “Segment” (or “Section” or “Group”).
No new result csv files are written from the child result (since it uses the parent result csv file).
If the parent result is cleared all children results are also automatically cleared to reflect the changes in the
parent.
Note 1: If changing the scoping of the parent result you need to manually change the “Weld Result Parent” list
object between to results as the scoping is retrieved when selecting a new parent result in the list.
Note 2: If a parent result property is changed without clearing the result object first the child results is not
cleared. You must manually re-evaluate the child result to see any changes.
- 46 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Lamellar Strength
The through-thickness toughness can be evaluated with the “Lamellar Strength” according to Eurocode 3
EN 1993-1-10 [4]. A verification model is saved in system “Lamellar Strength” in “WeldToolkit-
StrengthVerification_V212.1.wbpz”.
The lamellar tearing may be neglected if the following condition is satisfied: ZEd <= ZRd where ZEd is the required
design Z-value resulting from the magnitude of strains from restrained metal shrinkage under the weld beads.
ZRd is the available design Z-value for the material according to EN 10164, i.e. Z15, Z25 or Z35.
The required design value ZEd may be determined using:
ZEd = Za + Zb + Zc + Zd + Ze
In which Za, Zb, Zc, Zd and Ze are given in Table 3.2 (next page).
Select a weld to evaluate either by “Manual Select” or by a pre-defined fillet weld from the list.
Set the throat plate thickness. The values for Za and Zc are automatically defined.
To analyze if the weld has “Predominant compressive load” leave the list box at “Evaluate” otherwise set the
value to “Yes” or “No”. If “Yes” this parameter reduces Zc by 50%.
Based on the weld geometry select “Weld shape factor, Zb” from the list, see table on next side.
Select options for “Free shrinkage factor, Zd” and “Preheating factor, Ze” from the list.
The required maximum Z-value, ZEd, is listed based on the inputs.
The lamellar strength, ZRd, can be selected from the list or set to “Evaluate”.
Available result items are: [Section Length (Y)/Min thickness/Z_Ed/Z_Rd/FX (radial)/FY (parallel)/FZ
(axial)/Fsum/MY (parallel)/Weld angle]
Results can only be plotted using result average “Section”.
By using “Maximum over Time” the evaluation of “Predominant compressive load” checks all load steps to
determine if the weld is in compression when calculating the ZEd and ZRd.
- 47 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 48 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Mesh Result
To post process non-geometric element results such as the “Add Fillet Weld” Mesh Result menu can be used.
The menu contains short cuts for potting “Result File Item” results.
To limit the plot to a specific bolt group first plot the material number (PNUMMAT) and probe the number for
the part of interest (15). Then type this number (or a range of numbers) in the “Solver component IDs”
property field in the result object to obtain a similar plot like in the second row below.
To limit the plot to only weld elements set the “Item Type” to “Element Name IDs” and the “Solver component
IDs” to 185. Note: you may have to hide the geometry bodies as they may also use element name 185.
- 49 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
To clean up the solution folder or to force a re-evaluation for a weld results without re-solving the analysis
select the result in the model tree and click the button “Clear selected weld result files”.
Note: The weld result object is not cleared, and the result summary listing and csv file are kept.
- 50 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Load cases from single step, load case combination or load case scanning can be defined.
Mean stress correction according to Goodman, Soderberg, Gerber, ASME Elliptical and Modified Goodman can
be used in CSV, Linearized, Nominal and Hot-Spot method.
Cumulative damage from a duty cycle consisting of several load cases can be evaluated.
S-N curves from IIW, DNV GL RP-C203, and Eurocode 3 are included, and additional curves can be added.
Fatigue evaluation using a S-N curve works in the same way as Ansys fatigue tool, but the difference is that the
Ansys tool is used for the part material fatigue excluding welds.
- 51 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
S-N curve
FAT Class: List of available S-N curves (defined in “weldFatiguePref.py”). Use “User defined” to edit S-N curve
properties manually (otherwise the properties are in read only mode).
Default S-N curve for each fatigue method can be defined in the preference file, see figure below.
FAT (@ Nfat cycles): Weld fatigue class. Stress range at Nfat cycles.
FAT factor: Scale factor for FAT value. E.g. to apply a thickness or temperature modification factor.
Nfat: Number of cycles for defining FAT (2E6).
Nc: Break point between slope m1 and m2 (1E7).
Slope m1: S-N curve slope for N < Nc.
Slope m2: S-N curve slope for N > Nc.
- 52 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Load Types
Zero Based
Calculates a pulsating stress range by scaling load step
“First time” with “Load scale factor”.
Fully Reversed
Calculates an alternating stress range by scaling load step “First
time” with “Load scale factor*2”.
Ratio (Loading Ratio)
Calculates custom stress range defined by scaling load step
“First time” with “Load scale factor*(1 - Ratio)”
Load Combination
Calculates the stress range between step “First time” S
and “Last time” and scale with “Load scale factor”
(Not available for CSV Fatigue)
T1 T2
Load Scanning
Calculates the maximum stress range between step
S
“First time” and “Last time” and scale with “Load scale factor”
(Not available for CSV and Linearized Fatigue)
T1 T2
Solution Combination
A general load step combination with two or more load steps in
the same analysis.
The resulting combination defines the stress range.
1. To edit the ”Solution Combination” click on ”Tabular
Data”
2. Click the ”Add row” in the table editor
3. Define the time step (must be greater than 0)
4. Define the load step scaling coefficient (must not be 0)
5. To delete a row right-click on a cell and select “Delete
selected row(s)”
Click ”Apply” to save the data and close the table editor.
(Click ”Cancel” to close without saving).
Do not click the red ”Close window” button.
(Not available for CSV Fatigue)
- 53 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
If the stress in a point for the selected load case is negative, e.g. S = -100, and Ratio=-0.5 the stress range is,
Srange = abs(1*-100 – -0.5*-100) = abs(-100 – 50) = 150
The stress ratio, R = Smin/Smax = -100/50 = -2!
If the stress in a point is positive, e.g. S = 100, and Ratio = -0.5,
then Srange = abs(1*100 – -0.5*100) = abs(100 + 50) = 150, R=50/100 = 0.5!
The “Loading Ratio” will equal the “Stress Ratio” only in points where the stress is positive!
Defining a load as a “Zero based” or “pulsating” load may in some areas create stresses with R=0 and in other
areas R=-inf depending on the stress sign in the load case!
The number of combinations increase fast with number of load steps, which is why this feature should be used
with care to avoid long evaluation times.
When using Normal stress, Hot-Spot or Effective Notch method the stress orientation is constant for all steps,
so the min and max stress are found direct from “Maximum/Minimum over time” and the stress range is
derived without performing load case combinations.
30
25
20
15
10
5
0
2 3 4 5 6 7 8 9 10
Load steps
- 54 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Based on the mean stress, Savg, the stress range, Srange, is corrected according to the following equations:
Goodman: S’range = Srange/(1-Savg/Rm) if 0 < Savg < Rm
Soderberg: S’range = Srange/(1-Savg/Ry) if 0 < Savg < Ry
2
Gerber: S’range = Srange/(1-(Savg/Rm) ) if abs(Savg) < Rm
2
ASME Elliptical: S’range = Srange/sqrt(1-(Savg/Ry) ) if 0 < Savg < Ry
Modified Goodman: S’range0 = Srange/(1-Savg/Rm) if -Rm < Savg < Ry
if Savg > 0: S’range1 = S’range0*(0.5*Srange/(Ry-Savg), if Savg <= 0: S’range1 = S’range0*(0.5*Srange/(Rm+Savg)
S’range = max(S’range0, S’range1)
150
100
50
0
-400 -350 -300 -250 -200 -150 -100 -50 0 50 100 150 200 250 300 350 400
Mean Stress [MPa]
Note: The Modified Goodman uses a two step approach to first derive a corrected range using Goodman
equation and the modify the range based on average stress distance to Ry or Rm.
Fatigue Result
Available Result Items are defined as follows:
Life [N]: Number of cycles for failure at defined stress range, N(S).
log10(Life) [N]: Convenient method to plot the order of magnitude of life, log10(N(S)).
Damage per block [-]: Ratio of load block number of cycles to Life, D = Nb/N(S)
Safety factor life [#blocks]: Number of loading blocks, SFN = 1/D = N(S)/Nb
Stress range: Stress range (including mean stress correction if used), S.
Safety factor stress: Ratio of allowed stress range to stress range, SFS = S(Nb)/S
Stress utilization: 1/SFS = S/S(Nb)
Life Quality: Quality measure based on mesh size, see section on following pages.
Stress max: Maximum stress in the fatigue load case.
Stress avg: Average (mean) stress in the fatigue load case.
Stress min: Minimum stress in the fatigue load case.
First time: First of the identified time steps when using “Fatigue Scanning”.
Last time: Last of the identified time steps when using “Fatigue Scanning”.
Path pos: Path coordinate along Hot-Spot edge.
- 55 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Definition
By: Default = “Time” (Cannot be changed)
Display Time: Time step selected from “First Time” in Load case definition (Read only).
The nominal stress range should be within the limits of the elastic properties of the material.
If the following conditions are not fulfilled a warning message is issued.
Nominal stress range nom < 1.5Ry or max stress nom < Ry
Hot spot stress range HS < 2Ry or max stress HS < Ry
Use the results “Stress range” and “Stress max/min” to review the condition.
- 56 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
CSV Fatigue
The CSV Fatigue Method is a generic post processing method to evaluate the life result items based on nodal
or element stress values in a CSV text file (comma separated values). A weld strength result may be used to
post process the fatigue in a weld using the structural stress result.
The first column in the csv file must contain node or element numbers.
At least one column must contain stress results.
The first line must contain data headers with valid Workbench unit strings, e.g. [MPa] or (Pa). Both types of
brackets may be used around the stress unit.
The field separator may be “;” or “,”. If the separator “;” is used decimal comma “,” or decimal point “.” may
be used. If the separator “,” is used only decimal point “.” can be used.
CSV Geometry
Scoping Method: [All Bodies/Geometry Selection/Named Selection]
Geometry: Selection corresponding to the content in the CSV file. If the file contains edge results the scoping
must be “edges” otherwise the contour plot is blank. You may limit the plot by selecting fewer geometry
items.
CSV Method
CSV File: Open file dialog for external CSV text file.
CSV Stress: List box of available stress results. The header must include a valid stress unit sting
Result Location: [Node/Element]. If the CSV file contains node or element results.
Notes on CSV Stress: The selected stress is scaled based on the “Load Type” and the “Load scale factor”.
E.g. If using a CSV Stress that is a “Stress range” you need to apply a scaling factor of 0.5 if using Load Type
“Fully Reversed”.
- 57 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Inside
Scoping Method: [Geometry Selection/Named Selection]
Geometry: Edges, Faces or Nodes of solids on the “Inside”. Results are plotted on this geometry.
By using a subset of the face nodes the evaluation time is greatly reduced. Avoid large face selections.
Outside
Scoping Method: [Geometry Selection/Named Selection]
Geometry: Edges, Faces or Nodes on the “Outside”. For each “Inside” node a path is created to the closest
“Outside” node and the linearized stress is evaluated.
Linearized Method
Linearized Parent: [None/*] Select an existing parent result to evaluate a different stress type, item or result.
Stress Type: Linearized Stress of type [Absolute Principal/Maximum Principal/Middle Principal /Minimum
Principal/Stress Intensity/Equivalent/Sum of Principal/Normal X/Normal Y/Normal Z/Shear XY/Shear YZ/Shear
XZ]
Coordinate System: [List of Coordinate Systems] Visible for Normal & Shear Stress (Must be Cartesian with
“Manual” ID number and created before solving)
Stress Item: [Membrane/Bending/Membrane+Bending/Peak/Total]
Result Side: Selects the result location to display [Inside/Center/Outside].
Corner Nodes Only: [Yes,No] To speed up evaluation corner nodes are used by default.
Pinball Region: Search distance limit when creating a path between inside and outside geometry. “0” will
connect all nodes on the “Inside” geometry with the nearest node on the “Outside” geometry. When the
result is evaluated, the path is plotted as a green arrow. The arrows can be shown/hidden for a selected result
by toggle the tag “AlwaysPlotLinearized”.
- 58 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Fatigue Result
Once the result is evaluated a path object can be created automatically based on the maximum result using
the “Create Path” property. If the result is updated and the max location is changed the path can be updated.
This path can be used for additional post processing using the native linearized stress results.
- 59 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Nominal Fatigue
The nominal fatigue method is similar to Ansys Fatigue Tool and can be used to calculate the fatigue on the
surface of a part using a selected stress type and S-N curve.
Nominal Method
Stress Type: [Principal/Sum of Principal/Equivalent/Normal X/Normal Y/Normal Z], Default = Principal
Coordinate System: [List of Coordinate Systems] Visible for Normal Stress (Must be Cartesian). The selected
stress direction is plotted with a vector.
- 60 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Note:
“Principal” is the principal stress with the largest magnitude, S = max(abs(S1), abs(S2), abs(S3)).
“Sum of Principal” calculates the first stress invariant, S = S1+S2+S3.
“Equivalent” is the signed von-Mises Equivalent stress. (Sign from the largest principal stress).
When using Nominal Fatigue for weld fatigue evaluation according to the “Nominal Stress Method” it is the
user’s responsibility to read the geometric stress and life at correct location with respect to the selected weld
detail, e.g. using the “Normal X” and a local coordinate system.
With the nodal selection (in combination with Normal stress) the user can directly probe the life for a weld
joint from a single node without confusing the plot with irrelevant results.
It is important not to read the stress at the weld location (to exclude the influence of the weld itself) and also
find correct FAT value. (Structural Details Table 3.1 [6]). It is recommended to use Hot-Spot and/or Effective
Notch method for weld evaluation.
The method does not calculate a nominal stress based on the section forces and cross section area! The Hot-
spot method can be used to derive the nominal geometric stress used for nominal fatigue evaluation of welds,
see the next section for an example.
- 61 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 62 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Hot-Spot Fatigue
The Hot-Spot method calculates the maximum stress range at the weld hot-spot (weld toe) by extrapolation of
the normal stress perpendicular to the hot-spot edge (or the principal stress).
The linear and quadratic method can be used and the extrapolation points, a, b & c, can be edited based on
weld code and model thickness, t.
Different weld types and corresponding FAT values are found in Table 3.3 [6].
Principal stress
<60 deg
Normal stress
Reference Face
Scoping Method: [Geometry Selection/Named Selection]
Geometry: Faces connected to the hot-spot edges. The hot-spot stress is calculated from node results on this
face. Only one unique face for each Hot-Spot edge is allowed. If only one Hot-Spot edge is selected all
reference faces are used for stress calculation. Additional “unconnected” faces can be selected.
Reference location: [Top/Middle/Bottom/Top Unconnected Face/Bottom Unconnected Face/Weld Toe
Connected Face/Weld Toe Unconnected Face]. This property has new features. For a shell model
“Top/Middle/Bottom” indicate the face side. “Unconnected Face” allows for post processing on a “target”
face. “Weld Toe” allows to post process “Add fillet weld” and will calculate the edge offset using the “Offset”
property as “throat thickness”. See section “Extrapolation graphics” for examples.
- 63 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Extrapolation graphics
Before the result is evaluated the extrapolation lines are shown to verify that they fall within the reference
face and that the mesh is well defined. At least one unique node for each extrapolation line is needed.
The extrapolation lines may be projected to the surface if the variable “projectHotSpotLines=True” is set in the
preference file. This setting will not influence the result quality.
To always show the Hot-Spot extrapolation lines use the tag “AlwaysPlotHotSpot” on the result.
The default setting for “AlwaysPlotHotSpot” is defined in the preference file.
There is a debug option in the preference file that will plot the hot-spot nodes and extrapolation lines when
evaluating a weld result. The line indicates the extrapolation normal and stress direction. If the geometry is
curved the direction is projected onto the surface. When changing between evaluated results the nodes and
lines will not be visible anymore.
- 64 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The new “Weld” feature in meshing in 2021 R1 allows to connect shell models with weld elements.
To post process on the “target face” include the face in the “Reference Face” scoping.
The direction of the hot-spot extrapolation lines and offset can be swapped by using a negative thickness and
negative offset, see section “Extrapolation direction”.
The “Unconnected Face” can also be used on solid models connected with contacts or “Add Fillet Welds”.
- 65 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
When welds are created using “Add Fillet Welds” the “Weld Toe” option will calculate the local edge offset
based on the throat thickness. The weld geometry is plotted with a green wire frame.
Reference location: Weld Toe Connected Face Reference location: Weld Toe Unconnected Face
Offset: 3 mm Offset: 3 mm
- 66 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Extrapolation direction
For models with T-junctions or internal edges the extrapolation direction can be switched by using a negative
thickness.
If the lines are “translated” or “scaled” the saved geometry information has been corrupted.
Solution: Open Space Claim and “cut and paste everything” (CTRL+A, CTRL+X, CTRL+V) and then close Space
Claim. This trick forces a geometry update that usually will resolve any graphical issues.
If the reference face is un-meshed the extrapolation lines may be shown at random side of the Hot-Spot edge.
- 67 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Mesh requirements
The mesh must be fine enough to allow one or two elements between the hot-spot and the first extrapolation
point as well as between the two (or three) extrapolation points.
The app will use a polynomial interpolation to calculate the stress at the extrapolation points, hence the mesh
does not need to be a perfect mapped mesh with nodes at the extrapolation lines.
- 68 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Extrapolation comparison
In [6] recommendations are made for mesh size, L, and extrapolation options for type A and B geometry.
In addition to the model mesh size 10 mm and 4 mm a model with mesh size 2 mm, “Extra Fine”, is included in
the comparison.
For Type A the three models give the exact same Hot-Spot stress.
For Type B the coarse model gives slightly lower stress (un-conservative).
Extrapolation comparison
800
700
600
500
Stress [MPa]
400
300
Type B, Fine (c) Type B, Coarse (d) 200
L= 4mm L= 10mm 0
Type A Type B
Life Quality
The result “Life quality” is an empirical factor of the ratio between the calculated life and the “true life”.
The quality is based on the distance, d, between the closest node to each extrapolation point.
Optimal quality is 1.0. If the same node is found for all extrapolation points the quality is set to 0.0.
Quality = 1 - (da/Xa)2 - (db/(Xb-Xa))2 - (dc/(Xc-Xb))2 (Linear extrapolation uses a and b only)
Xa
Xb
Xc da
db
dc
The singularity at the Hot-Spot influences the stress at the first extrapolation point. A coarse mesh will usually
result in a higher Hot-Spot stress and lower predicted life whereas a fine mesh allows the singularity stress to
be eliminated before the first extrapolation point resulting in higher predicted life.
- 69 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
750 SX L=2mm
SX L=3mm
700
SX L=4mm
Stress [MPa]
SX L=5mm
650
600
550
500
0 2 4 6 8 10 12 14
X [mm]
A parameter study of the element size, life and quality for a short segment of a tetrahedron mesh shows the
following two graphs for linear and quadratic extrapolation.
105% 105%
100% 100%
95% 95%
Life min rel. Life min rel.
90% 90%
Life trend Life trend
85% Quality min 85% Quality min
75% 75%
70% 70%
1 2 3 4 5 6 1 2 3 4 5 6
Element size [mm] Element size [mm]
Thickness, t=10 mm, a=0.4, b=1.0 Thickness, t=10 mm, a=0.4, b=0.9, c=1.4
For increasing element size the variation of life and quality increases but the trend is that the result “Life
quality” follows the calculated life. For thickness 10 mm the recommended element size is 2 mm in order to
have two elements before the first extrapolation point.
- 70 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Gap
Tangential direction
The notch result calculates the tangential stress range in the effective notch (cylindrical fillet).
Fillet radius R = 1 mm is valid for thickness ≥ 5 mm [6]. For thinner parts R = 0.05 mm may be used but other
recommendations may exist. The app will not check the notch radius or part thickness. The FAT class depends
on material and notch radius and common values (implemented in the app) are found in the table below [6].
Material R = 1 mm R = 0.05 mm
Note: You may use the Nominal Fatigue method to obtain the maximum principal stress range if the fillet is not
a perfect cylinder, e.g. a torus, or if you do not want to use the tangential stress.
- 71 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Life Quality
The expected life is highly sensitive to the stress range. A stress convergence study shows that 2nd order brick
elements require 24 elements/360 degree, and first order elements require 40 elements/360 degree.
The result “Life quality” is the ratio between the calculated life and the “true” life as a function of normal angle
difference, phi, over the element. A coarse mesh over predicts the life so dividing the calculated life with the
quality is a rough estimate of the “true” life.
Second order tetrahedron elements tends to give higher stress compared to brick elements for the same mesh
resolution and are therefore conservative. First order tetrahedron elements must never be used.
Using inflation layers on a tetrahedron mesh improves the result and is recommended practice.
Note: The Nominal method uses the same definition for “Life quality” for solid models.
400%
250%
300% 200%
150%
200%
100%
100%
50%
0% 0%
8 16 24 32 40 0 10 20 30 40
#elements/360 degrees Phi [deg]
- 72 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
For a shell model (1st order) the Hot-Spot method life is 25% lower compared to Nominal.
In this test the new “Weld” mesh method is used to create the weld mesh including the mesh imprint for Hot-
Spot extrapolation, see the paragraph “Weld Mesh method” in the Hot-Spot section.
The Hot-Spot result is very sensitive to the mesh method, size and quality at the hot spot, e.g. solid vs. shell,
contact vs. multi-body, with or without weld elements. In this example the Hot-Spot life could differ as much
as 50% compared to the Nominal life.
Nominal Hot-Spot
Life Comparison
2.50E+05
2.00E+05
Life [Cycles]
5.00E+04
0.00E+00
Nominal Hot-Spot Effectiv Notch Linearized
- 73 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Child Fatigue
A child result let you plot different Result Items from a parent fatigue object without the need for re-
evaluation, e.g. for Hot-Spot or Linearized method.
The scoping of the child is automatically set when selection the parent in the list.
The child does not create any output csv since it uses the parent csv file.
When evaluating all results the child results are evaluated after the parents to make sure the updated parent
result file is used.
Parent Child
- 74 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Cumulative Damage
A fatigue duty cycle built of different loading blocks can be evaluated using the Cumulative Damage method.
Grouping result objects of the same type with the same geometry scoping and FAT Class but different load
cases together with a “Cumulative Damage” object will sum the damage from the grouped objects and
calculate the total damage and safety factor results. You may drag and drop result objects into or out from the
group to edit the duty cycle.
Do not group different result items of the same load case, e.g. Life, Damage and Stress range, since this will
sum the damage for each one, use a “Child Result” to plot those result instead! You may have several
“Cumulative results” and “Child Results” in the same group.
Geometry
Scoping Method: [Geometry Selection/Named Selection]
Geometry: Edges or Faces from grouped result objects.
S-N curve
FAT Class: Fatigue S-N curve. (Read Only)
FAT: Weld fatigue class stress. (Read Only)
FAT factor: Scale factor for FAT value (Read Only)
Nfat: Number of cycles for defining FAT (Read Only)
Nc: Break point between slope m1 and m2. (Read Only)
Slope m1: S-N curve slope for N < Nc. (Read Only)
Slope m2: S-N curve slope for N > Nc. (Read Only)
- 75 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Fatigue Result
Available Result Items are defined as follows:
Cumulative Damage [-]: Sum of the damage from each load block, Dcum.
Safety factor life [#blocks]: Number of loading blocks, SFN = 1/Dcum = N(Seqv)/Ncum
Equivalent Stress range: Constant stress range with same total damage as the duty cycle, Seqv
Safety factor stress: Ratio of allowed stress range to equivalent stress range, SFS = S(Ncum)/Seqv
Stress utilization: 1/SFS = Seqv/S(Ncum)
Life Quality: Quality measure based on mesh size.
Definition
By: Default = “Time”
Display Time: Time step to use for deformed shape. Does not influence result.
- 76 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The text file can be used in e.g. Excel and also with the free app “CSV-Plot”.
Use the results “Stress range” and “Stress max/min” to verify that condition one is fulfilled. Also verify the
fatigue resistance of the parent material.
Note: All IIW or DNV GL S-N curves are limited by the parent material (FAT160 & B1)
It is the user’s responsibility to ensure that the FE-model, chosen fatigue method, input values and results
obtained by this application is suitable for his/her intended purpose, e.g. to evaluate according to a specific
design code or to apply fatigue modification factors due to misalignment etc.
- 77 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Weld Report
A HTML formatted report of all weld objects and results including any comments, figures and images is created
with a click on “Weld Report”. The style settings are defined in the “Weld Report Preference”, see next
section.
The image export settings are defined in the standard Mechanical Options under “Graphics” and “Report”.
The property “Current Graphics Display” is ignored and images are always exported with the settings defined.
- 78 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Add text to your weld objects by using “Comment” and add “Figures” or static “Images” using the
corresponding feature in the “Insert” menu. Comment and Figure objects added to the “Analysis” will be
included in the beginning of the report.
Result objects can be grouped to create a heading in the report. Comment and figure objects in the group will
be printed before the results in the group.
The report is saved in the project “user_files” folder in a subfolder with the same name as the parent folder for
the solver files directory, e.g. “SYS” or “SYS-1”.
See the demo or verification project for examples on how to use comments, figures and images.
The EDRMedeso app “Report Generator” can also be used to include bolt objects details and results.
- 79 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Open Preference
Click one of the preference buttons to edit the corresponding settings. The preference files are located in the
app installation folder (%appdata%\Ansys\v212\ACT\extensions\WeldToolkit_V212.1).
The changes are applied next time you open Workbench or click “New Project”.
When welds are post processed the MAPDL solver is used and a custom license increment can be used instead
of the default one, “postLicenseMAPDL”.
- 80 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The weld codes are defined using a Python dictionary where the user can add key words and expressions to
define the material parameters, dimensional weld strength and weld stress used in the evaluation. The
expressions must be valid Python syntax, see steps 1 to 6 below.
- 81 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
- 82 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
This can be used to define default settings for a specific design code.
Custom S-N curves can be added to the app using the new API found below “# FAT Class Dictionary”.
Curves for IIW, DNV and EC3 are included and shown in the following pages [6], [7], [3].
One additional feature when defining a S-N curve in the preference file is the possibility to include a second
break point, N0, and a corresponding slope, m0 and a cutoff limit Ncutoff. This is used for IIW and DNV to “limit”
a curve with the base material curve.
- 83 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
FAT125 steel
FAT112 steel
FAT100 steel
FAT90 steel
Stress range [MPa]
FAT80 steel
FAT63 steel
FAT56 steel
FAT50 steel
FAT45 steel
FAT40 steel
FAT36 steel
10
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 1.0E+09
#Cycles
Modified resistance S-N curves of steel for Palmgren-Miner summation, (Fig 4.1) [6]
IIW S-N curves Nominal & Hot-Spot Method (Steel) Variable amp.
1000
FAT160 steel vari
Note: In the preference file there are also S-N curves defined for “Standard application” Fig. 3.1.
These curves are deactivated by default but can be activated by the user by editing the preference file.
IIW does not specify a cutoff limit, Ncutoff = 1e10 cycles is used.
- 84 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
FAT50 aluminium
FAT45 aluminium
FAT40 aluminium
FAT36 aluminium
Stress range [MPa]
FAT32 aluminium
50 FAT28 aluminium
FAT25 aluminium
FAT22 aluminium
FAT18 aluminium
FAT16 aluminium
FAT14 aluminium
FAT12 aluminium
5
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 1.0E+09
#Cycles
Modified resistance S-N curves of aluminium for Palmgren-Miner summation, (Fig 4.2) [6]
IIW S-N curves Nominal & Hot-Spot Method (Alu.) Variable ampl.
500
FAT71 alu vari
Note: Curves for aluminum are limited by FAT71 (parent material) whereas curves for steel are limited by
FAT160.
IIW does not specify a cutoff limit, Ncutoff = 1e10 cycles is used.
- 85 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
IIW S-N curves Effective Notch Method, Constant & Variable Ampl.
1000
FAT225 R1 steel
FAT71 R1 aluminium
FAT28 R1 magnesium
FAT630 R0.05 steel
FAT180 R0.05 aluminium
Stress range [MPa]
10
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 1.0E+09
#Cycles
IIW does not specify a cutoff limit, Ncutoff = 1e10 cycles is used.
D
E
100
F
F1
F3
G
W1
W2
W3
10
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 T
#Cycles Steel
- 86 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
D
E
100 F
F1
F3
G
W1
W2
W3
10 T
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08
#Cycles
DNV Table 2-3 S-N curves in seawater for free corrosion [7]
D
E
100 F
F1
F3
G
W1
W2
W3
10 T
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08
#Cycles
- 87 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
FAT90
FAT80
100
FAT71
FAT63
FAT56
FAT50
FAT45
FAT40
FAT36
10
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 1.0E+09
#Cycles
Note: Slope m2 = 1e6 is used from knee point at Nc = 5e5 up to N=1e8. Ncutoff = 1e8 cycles is used.
Figure 7.1: Fatigue strength curves for direct stress ranges, Variable amplitude [3]
FAT90 vari
FAT80 vari
100
FAT71 vari
FAT63 vari
FAT56 vari
FAT50 vari
FAT45 vari
FAT40 vari
FAT36 vari
10
1.0E+04 1.0E+05 1.0E+06 1.0E+07 1.0E+08 1.0E+09
#Cycles
- 88 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
The style settings for text paragraph, headings, captions and tables are defined using html5 syntax.
- 89 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Licensing Features
Projects using the EDRMedeso license feature has several benefits compared to the Ansys app license.
• You may open a Workbench project without the app license being checked out.
• You may also open Mechanical without the app license being checked out.
(This allows the model to be shared with people without access to the app or license.
Just make sure to “Save Binary Extension with Project”, see “WB>Tools>Options…>Extensions” below.)
• You may activate the app license to reserve it for your continuous use. “Check Out License”
• You may release the app license from the current Mechanical session to use it in another session
within the same project or a different project or by a different user. “Check In License”
• You may check the status of available licenses and who is using the license. “Check License Status”
• The app license is automatically checked out when evaluating a feature during solve or post
processing.
• If the license is not available a warning message is displayed in Mechanical.
If the connection to the license client is lost use “Initiate Licensing” to reconnect or to locate the license client
and update the license user variable. See the “EDRMedeso_License_client_installation.pdf” for details.
- 90 -
Weld Toolkit - Documentation – v.212.1 -18-Nov-21
Known Issues/limitations
• Very long project path names or regional characters may cause the evaluation to fail.
Common practice is to use only alphanumerical letters and underscore in project name and file path.
In general projects may be saved using both “drive letter path” or “network path” and spaces and
regional characters are allowed in both project name and result object names. Invalid characters, e.g.
“*”, “?”, “\”, are removed from result object name when saving result csv files.
• The “First time” and “Last time” are used to find the nearest result step from the solution. If an exact
match is not found a warning message is printed.
• Linearized Stress result may fail to evaluate if node numbers are extremely large, >108. Add a “Mesh
Numbering” to compress the node numbers. This can happen after multiple partial updates of the
geometry and not clearing the mesh.
• Cumulative damage result will not change status to “Need update” if another group member is edited
and updated. You must manual click on the “Load Group Properties” field to load any changes in the
Cumulative Damage result and evaluate the result again.
• Evaluation of many weld result objects on large models is time consuming and may cause Mechanical
to crash. Always save the model before solving! To recover if Mechanical crashes after solving:
1. Open Mechanical and suppress all the weld result objects.
2. Right click on Solution group and “Open Solver Files Directory” and locate “file.rst”.
(If not found re-solve the model.)
3. Use “Solution>Tools>Read Result Files…” and select “file.rst” from step 2 and save the model again.
4. Un-suppress the weld result objects and evaluate.
References
[1] ANSYS Help 2021R2 online documentation.
[2] EN 1993-1-8 (2005) (English): Eurocode 3: Design of steel structures - Part 1-8: Design of joints
[Authority: The European Union Per Regulation 305/2011, Directive 98/34/EC, Directive 2004/18/EC]
[3] EN 1993-1-9 (2005) Eurocode 3: Design of steel structures - Part 1-9: Fatigue
[Authority: The European Union Per Regulation 305/2011, Directive 98/34/EC, Directive 2004/18/EC]
[4] EN 1993-1-10 (2005) (English): Eurocode 3: Design of steel structures - Part 1-10: Material toughness
and through-thickness properties [Authority: The European Union Per Regulation 305/2011, Directive
98/34/EC, Directive 2004/18/EC]
[5] ANSI/AISC 360-16 Specification for Structural Steel Builds. July 7, 2016
[6] Recommendations for Fatigue Design of Welded Joints and Components, Second Edition. A.F.
Hobbacher. International Institute of Welding (IIW)
- 91 -