Command manual

Command list


pid${}_{bolt}$, pid${}_{nut}$, cid, $sf$, $t_{beg}$, $t_{end}$

Parameter definition

pid${}_{bolt}$ Bolt part ID
pid${}_{nut}$ Nut part ID
cid ID of a CURVE or FUNCTION defining bolt shaft stress versus time
$sf$ Shaft stress curve scale factor
default: 1
$t_{beg}$ Start time
$t_{end}$ End time
default: 1.0e20


This command is used to pre-stress a set of bolts and to apply balancing forces to the corresponding nuts. pid${}_{bolt}$ is assumed to contain one or several bolts. pid${}_{nut}$ must contain the same number of nuts. The command identifies the discrete bolts and nuts and creates bolt-nut pairs. The bolt shafts are pre-stressed with the axial stress defined by curve cid.

Models with bolted connections need to be run in two steps, where the first step tightens the bolts. When the pre-stressing phase is finished, the model (in its current state) needs to be output to a set of state files. impetus_stateX.k contains the the geometry and information about the contact state. impetus_stateX.bin is a binary file with all element stresses and state variables. Finally, impetus_state_boltX.k contains MERGE commands for each nut/bolt pair. These state files are used as command files for the second step, where the structure is exposed to the loads of interest.

Note that the state file output is defined in the command OUTPUT.


Prestress bolt
Bolted connection
Bolted connection

The following commands define an axial bolt shaft stress of 200MPa. The bolts are in part 3 and the nuts in part 4. The applied shaft stress ramps up from 0 to 200MPa in 1ms and is then held constant.

# Step 1 - pre-stress
0, 0, ALL
"M12 bolts"
3, 4, 50
"shaft stress versus time"
0, 0
1.0e-3, 200.0e6
1, 200.0e6

The OUTPUT command is defined to output state files for the complete model at termination. These state file are to be included in the next modeling stage, where the nuts are clamped to the bolt shafts and the structure can be exposed to the desired load case:

# Step 2 - include state from Step 1
# elements, nodes and the final state after Step 1
# file with commands that clamp the nuts to the bolts

impetus_state_boltX.k contains MERGE commands that lock the nuts to the bolts:

"bolt (1,1)"
G, 10001, G, 10002
101049, 0, 95.0
101002, 0, 95.0
"bolt (1,2)"
G, 10003, G, 10004
101167, 0, 95.0
101120, 0, 95.0

Each bolt/nut pair has its own MERGE definition. As a consequence merge.out will have one force history curve for each bolt/nut pair.

Bolted connection at the beginning and end of Step 2
Bolted connection at the beginning and end of Step 2