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
| Command | Description | Usage | Note |
|---|---|---|---|
|
API allowable stress header command |
C | ||
|
Units of length and force Yield stress |
|
1 | |
|
Groups to be reported Elements to be reported Sections to be reported Search for maximum forces and stresses Secondary members |
C C |
2 2 | |
|
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 | |
|
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 | |
|
Reports to be printed Text or comment command Redefine global title | |||
|
Terminates command data block |
C |
Usage
C Compulsory command, but see notes below where applicable.
Notes
See the Command Reference section, specifically the UNIT command.
Compulsory for non-tubular elements unless Sections have been used in the preceding analyses for all elements to be processed.
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