5.3.1. API WSD JOIN Overview

The API WSD JOIN command requests that a joint check be performed. The check differs from the punching shear check as defined in revision 2 of the 21st edition of the API’s RP 2A-WSD Clause 4.3 or later editions, this supersedes earlier NOMI or PUNC checks required for earlier versions.

The joints may consist of TUBE elements and/or other beam types that have been assigned tubular sections in the structural analysis.

Joints for the API check post-processing are selected using the JOINt command in BEAMST which specifies the node numbers at joint positions. All joints are assumed ‘simple’. Elements may be excluded from the joint punching shear check using the SECOndary command.

Joints are automatically classed as a combination of K, T or Y depending on the loading applied. A maximum of 5 types per brace member is permitted; results are produced for each brace forming the joint.

  1. The chord member is the member with the greatest outside diameter.

  2. If two or more potential chord members have equal diameters; BEAMST will consider the two with the largest wall thicknesses and for each loadcase selected will check the one most heavily stressed against all brace members.

  3. In the case of two or more potential chord members with equal diameters and wall thicknesses, the first two encountered as shown in the Cross Check Report will be considered.

  4. If the CHOR command is used to specify a chord member, this alone will be considered. If two chords are specified, the most heavily stressed chord will be checked against all brace members for each loadcase selected.

  5. All members not selected as chord members are treated as brace members (unless defined as secondary), with each brace-chord pair being checked.

A joint is formed of a maximum of 3 nodes connected by valid chord members. These nodes must form a straight line and must be within a distance of D/4. This process is performed automatically, however, if required can be specified manually using the CHOR command.

All valid members that form the joint are allocated to a number of planes. A tolerance of +/- 15° exists to identify braces belonging to the same plane. Each member in each plane is then assessed to obtain unity factors for axial and bending forces in addition to an interaction ratio to account for the combination of such forces.

BEAMST automatically decides on the type of joint by assessing the balancing axial force in each valid brace member forming the joint. Firstly any load paths that form a K joint are assessed; it can be the case that in a traditional KT Joint shape that this will result in 2 K joints with different gaps between members.

All forces that transfer across the joint to an opposite brace will form X Joints; again it is possible that multiple X Joint load paths co-exist within one joint; in this case these will be calculated with the appropriate offsets. Finally, any shear that exists in a joint will be accounted for by the provision of a Y joint type. The final joint capacity will be calculated using the proportion of axial load that is allocated to each of the joint types.

BEAMST will only check selected joints in which two or more incident members are tubular and of circular section. All other selected joints are automatically bypassed.

The user may override these classifications using the TYPE and CHOR commands. Interpolated joint classifications may be defined using the TYPE command. For K joints a gap dimension appropriate to the joint may be specified in the TYPE command. A default gap dimension may be specified using the GAPD command.

The detailed joint check report provides information on joint geometric parameters, type, acting chord and brace stresses, punching shear, Qf and Qu factors, punching shear allowable(s), and unity checks. This may be requested using the PRINt UNCK command. The maximum unity check is flagged for ease of reference. When an interpolatory joint type classification is being employed two sets of punching shear allowables are reported, one for each joint classification type and these pertain to joints classified as 100% of the respective joint types.

Summary report 3 contains the highest unity check for each selected loadcase for each joint.

Summary report 4 contains the three worst unity checks for each selected joint, together with the distribution of unity check values. This distribution provides information on the number of unity checks exceeding an upper limit (default 1.0), less than a lower limit (default 0.5), and the number in the mid range.

BEAMST commands applicable to the API punching stress command are given in Table 5.5: API WSD JOIN Commands below and are described in detail in BEAMST Command Reference. An example data file is given in Example 5.3: Example API WSD JOIN data file.

Table 5.5:  API WSD JOIN Commands

CommandDescriptionUsageNote

API WSD JOIN

API joint check header command

C

 

UNIT

YIEL

Units of length and force

Yield stress


C

1

JOIN

TYPE

CHOR

SECO

Joint numbers to be reported

Joint type and brace element definition

Chord elements at a joint

Secondary members to be ignored in checks

  

DESI

GAPD

PROF

STUB

Defines design section properties

Defines default gap dimension

Section profiles for use in design

Tubular member end stub dimensions

  

CASE

COMB

CMBV

SELE

SPEC

RENU

EXTR

QUAK

Basic loadcases to be reported

Define a combined loadcase for processing

Define a combined loadcase for processing

Select/redefine a combined/basic loadcase title

Basic loadcases from response spectrum analysis

Renumber a basic loadcase

Loadcases allowing extreme loading overstress

Loadcases with earthquake permitted overstress

C

C

C

2

2

2

PRIN

TEXT

TITL

Reports to be printed

Text or comment command

Redefine global title

  

END

Terminates command data block

C

 

Usage

C Compulsory command, but see notes below where applicable.

Notes

  1. See the Command Reference section, specifically the UNIT command.

  2. At least one CASE, CMBV or COMB command must be included.

Example 5.3:  Example API WSD JOIN data file
SYSTEM DATA AREA 100000
TEXT BEAMST USER MANUAL EXAMPLE STRUCTURE T0847
JOB POST
PROJECT MANU
COMPONENT PILE JACA
OPTION GOON
END
API ED21 JOIN
*
* Investigate all joints in the model except where
* only one element is connected
*
JOINT ALL
NOT JOINTS 1315 1355 5110 5150
*
* Ignore dummy elements
*
SECONDARY ELEMENTS 801 802
UNIT KN M
*
* Change tubular dimensions for one element
*
DESI TUB 1.0 0.05 ELEM 131
*
* Examine two wave cases
*
SELE 10 Extreme Wave 1 + Dead Loads + Topside Loads
COMB 10 1.0 1 1.0 3 1.0 4
SELE 11 Extreme Wave 2 + Dead Loads + Topside Loads
COMB 11 1.0 2 1.0 3 1.0 4
*
* Indicate that these loadcases are extreme events
*
EXTR 10 11
*
* Yield Value Constant for all elements
*
YIELD 3.5E05 ELEM ALL
*
* Specify the chord elements for one of the joints
*
CHORD 1130 122 123
*
* Set some joints as being Y
*
TYPE.OF.JOINT 1130 Y 102
TYPE.OF.JOINT 1130 Y 103
*
* Ask explicitly for all reports
*
PRIN XCHK UNCK SUNI N MM SUM3 BOTH SUM4 BOTH
END
STOP


Release 18.2 - © ANSYS, Inc. All rights reserved.