Skip to main content Link Menu Expand (external link) Document Search Copy Copied

appSettings Bolt Settings

Table of contents

About

General preference for rivets and bolts is managed by the “Bolt Settings” object. This is useful for turning the plotting of “Bolt Id number” on/off or to edit the default values. The object is used for editing or adding bolt/rivet codes. The object is optional and can be deleted from the model if not used.

Details

Usage

Click “Bolt Settings” to add the Bolt Settings object to the model tree.

Existing data in the preference file “boltToolkitPref.py” is used when the settings is added.

  • To revert the Rivet/Bolt/General Settings right-click and select “Reset Bolt Settings”.
  • To update (and overwrite) the global preference file “boltToolkitPref.py” right-click and select “Save Bolt Settings”. A pop-up question “Overwrite existing Bolt Setting defaults?” prompts the user to confirm or cancel the save. (A backup copy of the app default values are saved in the file “boltToolkitPrefDefault.py”.)

Context

The Rivet/Bolt Codes and FAT Class are not modified by the “Save Bolt Settings”. They have separate save buttons, see the sections below.

General Settings

General Settings Description
Show Id number Yes (Default)/No Plot Id number on rivet/bolt head.
Show Geometry on Results Yes (Default)/No Plot rivet/bolt geometry on results.
Load Translucency (Default 0.0) Translucency of rivet and bolt objects (0: Solid, 1: Transparent)
Result Translucency (Default 0.7) Translucency of rivet and bolt objects in results.
Store Results At All Available Time Points (Default)/Last Time Point (i)
Post processing MAPDL license (Default) Specify custom license increment to use in post processing (ii).
Calculate Utilization/Safety Factor Utilization Factor (Default)/Safety Factor (iii).
Automatic Bolts Fatigue Legend Yes (Default)/No
Rivet Settings  
Rivet coincident tolerance 0 < 0.05 (Default) < 1 Tolerance factor on “Max Thickness” for coincident rivet holes.
Print Rivet Id centroid in results table Yes/No (Default) Print rivet Id centroid in results table.
Write Rivet Data to CSV Yes/No (Default) Write rivet coordinate csv file (instead of to output file solve.out).
Bolt Settings  
Show Bolt Coordinate System Yes/No (Default) Plot bolt coordinate system at bolt shaft mid.
Advanced Bolts Contact Morph Morph (Default)/No Morph Sets the tag “advBoltNoMorph” when creating advanced bolt.
Print Bolt Id centroid in results table Yes/No (Default) Print bolt Id centroid in results table.
Write Bolt Data to CSV Yes/No (Default) Write bolt coordinate csv file (instead of to output file solve.out).
Scale Only Pretension Change Yes (Default)/No If “Yes” the “Scale Factor Value” scales only the “Pretension Change” part of “Normal Force”. (iv)
Rivet Code Editor  
Edit Rivet Code No (Default)/New/Eurocode 3 (v)
Bolt Code Editor  
Edit Bolt Code No (Default)/New/Eurocode 3/AISC 360-16 (v)
FAT Class Editor  
Edit FAT Class No (Default)/Yes

(i) Store Results At

If the Analysis Setting/Output Controls is “Store Results At = All Time Points” and the result file contains many sub steps this setting can limit post processing to “Last Time Point” for each load step to speed up post processing time.
If the Analysis Setting/Output Controls is “Store Results At = Last Time Point” then this setting does not influence the post processing time.
Changing this property has only effect before solving and post processing the model.

(ii) Post processing MAPDL license

Default,Mechanical Pro,Mechanical Premium,Mechanical Enterprise,Mechanical Enterprise PrepPost,Mechanical Enterprise Solver

(iii) Calculate Utilization/Safety Factor

Result items are listed as “Utilization factor”, Uf*. If selecting “Safety Factor” result items are evaluated as Safety Factor, SF = 1/Uf

(iv) Scale Only Pretension Change

In previous versions setting a “Scale Factor Value” other than one (1.0) scaled all bolt forces and moments including “Normal Force” and “Contact Normal Force”.
The new default “Scale Only Pretension Change = Yes” will scale the change in “Normal Force”, i.e. “Pretension Change” and keep “Contact Normal Force” un-scaled.
The evaluation of result items “Normal Force”, “Uf_tension”, “Contact Normal Force” and “Uf_slip” is therefore correct since the pretension force is not scaled.
In “Random Vibration” or “Response Spectrum” analyses the “Scale Only Pretension Change” does not influence the results since the static pretension force is not part of the solution.

(v) Edit Rivet/Bolt Code

When selecting “New” an empty set of properties are displayed.
When selecting an existing code the corresponding properties are loaded.

Rivet/Bolt Code Editor

The Rivet/Bolt Code Editor is used to modify an existing code or to create a new. E.g. add more material grades or adjust an evaluation criteria.

The interface loads data from the file “boltToolkitPref.py”. New and modified codes are saved in a separate file, “rivetCodes.json” and “boltCodes.json”, in the app installation folder. This file is loaded and replaces the app original data when postprocessing.

To revert to the app original data the file “rivetCodes.json” or “boltCodes.json” can be deleted. When migrating to a new version of Bolt Toolkit the files can be copied to the new app installation folder.

The Rivet and Bolt codes are similar but the Bolt codes contains some additional properties marked with “(bolt)”.

Rivet/Bolt Code Editor Description
Edit Rivet/Bolt Code “Selected code”
New Rivet/Bolt Code Name Rename or delete the selected code (i)
Save Rivet/Bolt Code Apply/Cancel Click to save/update (or cancel)
Material grade Tabular Data editor for fur/fub, fyr/fyb, alphav, gammaM2 and gammaL.
Spacing  
End distance (parallel), e1 Hole spacing expression e1. Function of [d, d0].
Inner distance (parallel), p1 Hole spacing expression p1. Function of [d, d0].
End distance (perpendicular), e2 Hole spacing expression e2. Function of [d, d0].
Inner distance (perpendicular), p2 Hole spacing expression p2. Function of [d, d0].
Friction Class, mu hf (bolt) Tabular Data editor for mu, hf.
Resistance Factors  
Bearing resistance factor, alphab Factor expression alphab. Function of any parameter.
Bearing resistance factor, k1 Factor expression k1. Function of any parameter.
Tension resistance factor, k2 Tabular Data editor for k2.
Tension/Shear resistance factor, ktv (bolt) Tabular Data editor for ktv.
Friction safety factor, gammaM3 (bolt) Tabular Data editor for gammaM3 for each category.
Hole type factors, ks kb kv (bolt) Tabular Data editor for ks, kb and kv for each hole type.
Design strength  
Design preload, FpCd (bolt) Expression FpCd. Function of any Resistance Factor or any parameter.
Design shear resistance per plane, FvRd Expression FvRd. Function of any Resistance Factor or any parameter.
Design bearing resistance single lap joint, FbRd Expression FbRd. Function of any Resistance Factor or any parameter.
Design tension resistance, FtRd Expression FtRd. Function of any Resistance Factor or any parameter.
Design punching resistance, BpRd Expression BpRd. Function of any Resistance Factor or any parameter.
Design tearout resistance, BvRd Expression BvRd. Function of any Resistance Factor or any parameter.
Design slip-resistance per plane, FsRd (bolt) Expression FsRd. Function of any Resistance Factor or any parameter.
Design head contact resistance, FcRd (bolt) Expression FcRd. Function of any Resistance Factor or any parameter.
Category Tabular Data editor for selecting Uf for each category.
Criteria  
Uf_shear Expression. Function of FvRd and any load parameter
Uf_bearing Expression. Function of FbRd and any load parameter
Uf_tension Expression. Function of FtRd and any load parameter
Uf_punch Expression. Function of BpRd and any load parameter
Uf_slip (bolt) Expression. Function of FsRd and any load parameter
Uf_pretension (bolt) Expression. Function of FpCd and any load parameter
Uf_contact (bolt) Expression. Function of FcRd and any load parameter
Uf_combined Expression. Function of [FvRd, FbRd, FtRd, BpRd] and any load parameter

(i) New Code Name

If using the same name the code is updated.
If naming “delete”, “del”, “clear” or “remove” the selected code is deleted.

Material grade

The material tabular editor loads the available Material Grades from the selected code.
The following restrictions apply:

  • fyb, fyr > 0
  • fub, fur > 0
  • alphav > 0. Default = 0.6
  • gammaM2 > 0. Default = 1.0
  • gammaL >= 0. Default = 0.0 (Optional)
    If gammaL > 0 it sets the result Scale Factor Value.

MaterialGrade

Friction Class

The Friction Class “Name” is free to define.
The following restrictions apply:

  • mu >= 0. Default = 0.0
  • hf >= 0. Default = 0.0 (Optional)

If mu or hf equals zero (=0) it is undefined and will not be saved in the code.

FrictionClass

Tension resistance factor

For Rivets the k2 factor is a single value.
For Bolts the k2 factor can take options “Yes” and “No” and is used in Eurocode 3 to specify if “Countersunk bolt” is used.

  • k2 > 0. Default = 1.0

k2

Tension/Shear resistance factor

The ktv factor can take options “Yes” and “No” and is used in Eurocode 3 to specify if “Cut thread comply with EN 1090”.

  • ktv > 0. Default = 1.0

ktv

Friction safety factor

The gammaM3 safety factor can apply to each individual Category.

Available Category names: A bearing/B slip-resistant at serviceability/C slip-resistant at ultimate/C slip critical/D non-preloaded/E preloaded/F shear and tension

  • gammaM3 > 0. Default = 1.0

gammaM3

Hole type factors

The hole type factors, ks, kb and kv can apply to each individual Hole type.

Available Hole type names: Normal/Oversized/Slotted (perpendicular)/Slotted (parallel)/Long Slotted (perpendicular)/Long Slotted (parallel)

  • ks, kb, kv >= 0. Default = 1.0

holeType

Category

The Category tabular data sets what evaluations to be included in each Category.

Available Category names: A bearing/B slip-resistant at serviceability/C slip-resistant at ultimate/C slip critical/D non-preloaded/E preloaded/F shear and tension

Category

Available parameters

Parameter Description
d Nominal shaft diameter
ds Stress shaft diameter (bolt)
dm Head diameter
d0 Hole diameter
A Nominal shaft area
As Tensile stress area (bolt)
A0 Area of the rivet/bolt hole
Am Area of head contact (dm-d0)
Wb Shaft bending stiffness (pi*ds^3/32)
Wz Shaft torsion stiffness (pi*ds^3/16)
e1 End distance (parallel)
p1 Inner distance (parallel)
e2 End distance (perpendicular)
p2 Inner distance (perpendicular)
tp Thickness of the plate under the head or the nut
tpp Thickness of packing plate (spacer)
fyr Rivet yield strength
fur Rivet ultimate strength
fyb Bolt yield strength
fub Bolt ultimate strength
Fp Nominal bolt pretension force
alphav Shear strength factor
gammaM2 Safety factor (strength)
gammaM3 Safety factor (slip)

Available load parameters

Parameter Description
Fz Bolt/Rivet normal force (including pretension)
FvEd1 Shear force in bolt shaft
Mb Bolt/Rivet bending moment
Pcont Head contact pressure
FvEd2 Average bolt contact slip force per plane
FcEd Average bolt contact normal force per plane
FtEd Bolt/Rivet tension force (including pretension)
FvEd Shear force per plane (max of FvEd1, FvEd2)

FAT Class Editor

The FAT Class Editor is used to modify or add new FAT class S-N data.

The interface loads data from the file “boltToolkitPref.py”. The modified data is saved in a separate file, “fatClassDict.json”, in the app installation folder. This file is loaded and replaces the app original data when postprocessing.

To revert to the app original data the file “fatClassDict.json” can be deleted. When migrating to a new version of Bolt Toolkit the file can be copied to the new app installation folder.

FAT Class Editor Description
Edit FAT Class No (Default)/Yes
Save FAT Class Apply/Cancel Click to save (or cancel)
FAT Class List Tabular Editor

The following restrictions apply:

  • FAT > 0
  • 0 <= N0 < Nfat < Nc < Ncutoff If N0 = 0 then m0 is ignored.
  • 0 < m0, 0 < m1, 0 < m2

FATClassList

SNCurve