5.1.1. API WSD ALLO Overview

The API WSD ALLO header command in BEAMST is used to request member stress checks to API Working Stress Design recommendations (Ref. 2). The strength requirements of API WSD 21st ed (Ref. 26), as applicable to BEAMST, are the same as those of API WSD 20th ed (Ref. 2). Hence the equations for API 20th ed given in BEAMST API Theory of this manual also apply to API 21st ed.

The API WSD ALLOwable Command exists as a derivative of the AISC allowable stress check data described in AISC Load and Resistance Factor Design Member Check (AISC LRFD MEMB). The stress check follows an identical path to the AISC check except for TUBE elements or other beam types that have been assigned circular tubular sections in the structural analysis. For such elements the code checks are performed to the American Petroleum Institute supported design recommendation API RP2A, which refers to the AISC specification (Ref. 1), but amplifies the clauses particular to tubular members. Unstiffened tubular local buckling, allowable stresses taking into account inelastic shell buckling, member buckling and yield strength and unity checks are all performed to the API recommendations as detailed in API LRFD Allowable Stresses and Unity Checks. Amplification-reduction factors, Cmy and Cmz, are restricted to a maximum of 0.85 unless these values are user defined. TUBE element effective shear areas are rigidly restricted to one half of the cross-section area.

The API specification is written in terms of member yield strengths, so a YIELd command must be used to specify the yield strength. The units of the yield strength must be those of the UNIT command.

Members may be selected for processing by elements and/or groups. The member section types must be specified (if not specified in the structural analysis) using DESI commands. Further commands are available for defining topological characteristic of the members (EFFE, UNBR and ULCF) and specifying members that are classified as ‘secondary’ (SECO).

Loadcases from the preceding structural analysis may be selected for processing using the CASE command and/or new loadcases formed from combinations of existing loadcases using the CMBV and COMB commands. The AISC/API permitted one third increase in allowable stresses for wind extreme loading may be requested on a loadcase basis using the EXTR command. For seismic conditions, API permits a higher increase in basic allowable stresses for strength assessment taking member allowable actions to the point of first yield. This may be requested on a loadcase basis using the QUAK command.

The SECT command may be used to define intermediate points along a member at which member forces are to be evaluated, checked and reported. These are in addition to results automatically printed at the member end points and positions of any step change in cross-section properties. For the code checks it is necessary to ensure the maximum acting bending moment and stresses are evaluated. Since this may not occur at one of the ‘selected’ locations, BEAMST has a SEARch command which causes the moments and stresses to be evaluated at every L/4 and L/6 (L = beam length) for prismatic and stepped beams respectively. These extra locations are in addition to those selected and the results at these locations are only presented if they give the maximum moments or stresses.

The selection of output reports is made using the PRIN command with the appropriate parameters for the required reports. The PRIN command is also used to request the various summary reports available and to set exceedence values for the unity checks. Four summary reports are available:

Summary report 1 is requested with the PRIN SUM1 command and gives the highest local buckling, global buckling and yield unity check values for each element.

Summary report 2 is requested with the PRIN SUM2 command and gives the highest buckle check and all unity checks at the section with the highest yield combined stress unity check for each element.

Summary report 3 is requested with the PRIN SUM3 command and consists of the highest unity check for each selected loadcase for each element selected.

Summary report 4 is requested with the PRIN SUM4 command and provides the three worst unity checks for each selected group, together with the distribution of unity check values. The 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.

A complete list of the command set available for the API WSD code checks is given in Table 5.1: API WSD ALLO Commands below and described in detail in BEAMST Command Reference. An example data file is given in Example 5.1: Example of an API WSD ALLO data file.

Table 5.1:  API WSD ALLO Commands

CommandDescriptionUsage Note

API WSD ALLO

API allowable stress header command

C

 

UNIT

YIEL

Units of length and force

Yield stress

  
C

1

GROU

ELEM

SECT

SEAR

SECO

Groups to be reported

Elements to be reported

Sections to be reported

Search for maximum forces and stresses

Secondary members

C

C

2

2

DESI

PROF

EFFE

CB

CMY/CMZ

UNBR

ULCF

Defines design section properties

Section profiles for use in design

Effective lengths/factors

Pure bending Cb coefficient

Amplification reduction factors Cmy/Cmz

Unbraced lengths of element

Unbraced length of compression flange

C

3

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 33% overstress

Loadcases with earthquake permitted overstress

C

C

C

4

4

4

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 GROUP or ELEM command must be included.

  3. Compulsory for non-tubular elements unless Sections have been used in the preceding analyses for all elements to be processed.

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

Example 5.1:  Example of an API WSD ALLO data file
SYSTEM DATA AREA 100000
TEXT BEAMST USER MANUAL EXAMPLE STRUCTURE T0847    
JOB POST
PROJECT MANU
COMPONENT PILE JACA
OPTION GOON
END
API ED20 ALLO
*
* Horizontal plan bracing level -50 m
*
GROU 1
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
*
* Main plan bracing members use effective length    
* coefficient of 0.8
* Note that the element definition overrides the    
* group definition irrespective of order         
*
EFFE 0.8 ELEM 105 106
EFFE 0.8 ELEM 101 TO 104
EFFE 0.8 ELEM 107 TO 110
EFFE 1.0 GROU 1
*
* Out of plane unbraced lengths need redefining    
*
UNBR FACT 2.0 1.0 ELEM 105 106
UNBR LENG 15.0 7.5 ELEM 102 103
*
* Override program computed moment amplification RF
*
CMY 0.85 ELEM 102 103 105 106
CMZ 0.85 ELEM 102 103 105 106
*
* Check mid-span sections
*
SECT 0.5 ELEM ALL
*
* Ask explicitly for all reports
*
PRIN XCHK PROP UNCK FORC STRE SUNI N MM SUM1 SUM2 SUM3 SUM4 BOTH
END
STOP


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