ASTM-AISC materials

ASTM-AISC materials

Structural steel as specified in ASTM standard.

Predefined ASTM steel types: A36, A529, A572, A53, A992, A500, A307,

A325 (bolts M12 to M36)

class materials.astm_aisc.ASTM_materials.ASTMShape(name='')

Bases: object

Steel shape with ASTM/AISC verification routines.

Variables

name – shape name (i.e. W40X431)

getBiaxialBendingEfficiency(Nd, Myd, Mzd, Vyd=0.0, chiN=1.0, chiLT=1.0)
Return biaxial bending efficiency according to section H1

of AISC-360-16.

Parameters

  • Nd – required axial strength.

  • Mzd – required bending strength (major axis).

  • Vyd – required shear strength (major axis)

  • chiN – axial load reduction reduction factor (default= 1.0).

  • chiLT – lateral buckling reduction factor (default= 1.0).

getCompressiveCriticalStress(effectiveLengthX, effectiveLengthY, effectiveLengthZ)
Return the compressive critical stress of the member

according to equations E3-2 or E3-3 of AISC-360-16.

Parameters

  • effectiveLengthX – effective length of member (torsion).

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getCriticalStressE(effectiveLengthY, effectiveLengthZ, Fe)
Return the critical stress of the member according

to equations E3-2 and E3-3 of AISC-360-16.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

  • Fe – flexural or torsional elastic buckling stress.

getDesignCompressiveStrength(effectiveLengthX, effectiveLengthY, effectiveLengthZ)
Return the design compressive strength of the member

according to section E1 of AISC-360-16.

Parameters

  • effectiveLengthX – effective length of member (torsion).

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getDesignTensileStrength(Ae=None)
Return the tensile strength of the section according

to section D2 fo AISC-360-16.

Parameters

Ae – effective net area according to section D3.

getDict()

Put member values in a dictionary.

getFlangeGrossArea()

Return the gross area of the flange.

getFlangeMaximumBolt(boltSteelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>)
Return the maximum bolt to prevent beam flange

tensile rupture according to equation 7.6-2M of AISC 358-16.

Parameters

boltSteelType – bolt steel type.

getFlangeMaximumBoltDiameter()

Return the maximum bolt diameter to prevent beam flange tensile rupture according to equation 7.6-2M of AISC 358-16.

getFlangeMaximumHoleDiameter()

Return the maximum hole diameter to prevent beam flange tensile rupture according to equation 7.6-2M of AISC 358-16.

getFlangeYieldStrength()

Return the yield strength of the flange.

getFlexuralBucklingCriticalStress(effectiveLengthY, effectiveLengthZ)
Return the flexural critical stress of the member according

to equations E3-2 and E3-3 of AISC-360-16.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getFlexuralCriticalSlendernessRatio(effectiveLengthY, effectiveLengthZ)
Return the critical value of the flexural buckling

slenderness ratio of the member.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getFlexuralElasticBucklingStress(effectiveLengthY, effectiveLengthZ)
Return the flexural elastic buckling stress of the member according

to equation E3-4 of AISC-360-16.

Parameters

effectiveLengthY – effective length of member (minor axis).

Parem effectiveLengthZ

effective length of member (major axis).

getFlexuralElasticBucklingStressOnAxis(effectiveLengthY, effectiveLengthZ, majorAxis=True)
Return the flexural elastic buckling stress of the member according

to equations E4-5 or E4-6 of AISC-360-16.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

  • majorAxis – true if flexure about the major axis.

getFlexuralSlendernessRatio(effectiveLengthY, effectiveLengthZ)

Return the flexural buckling slenderness ratio of the member.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getNominalCompressiveStrength(effectiveLengthX, effectiveLengthY, effectiveLengthZ)
Return the nominal compressive strength of the member

according to equation E3-1 of AISC-360-16.

Parameters

  • effectiveLengthX – effective length of member (torsion).

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getProbableMaxMomentAtPlasticHinge(majorAxis)

Return the probable maximum moment at plastic hinge according to clause 2.4.3 of AISC-358.

getReferenceCompressiveStrength()

Return the flexural strength of the section without take in to account the lateral buckling effect.

getReferenceFlexuralStrength()

Return the flexural strength of the section without take in to account the lateral buckling effect.

getShearArea(majorAxis=True)
Return area for shear strength calculation (added for compatibility

with EC3 steel sections).

Parameters

majorAxis – if true major axis bending; so shear parallel to minor axis.

getTorsionalBucklingCriticalStress(effectiveLengthX, effectiveLengthY, effectiveLengthZ)
Return the torsional critical stress of the member according

to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

  • effectiveLengthX – effective length of member (torsion).

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

getWebSuitableBolt(ratio=2.5, boltSteelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>)
Return the a suitable bolt to be used in the profile web

based on the web thickness.

Parameters

  • ratio – bolt diameter / web thickness ratio.

  • boltSteelType – bolt steel type.

getYShearEfficiency(Vyd)

Return major axis shear efficiency according to AISC-360-16.

Parameters

Vyd – required shear strength (major axis)

getZBendingEfficiency(Nd, Mzd, Vyd=0.0, chiN=1.0, chiLT=1.0)
Return major axis bending efficiency according to section H1

of AISC-360-16.

Parameters

  • Nd – required axial strength.

  • Mzd – required bending strength (major axis).

  • Vyd – required shear strength (major axis)

  • chiN – axial load reduction reduction factor (default= 1.0).

  • chiLT – lateral buckling reduction factor (default= 1.0).

getZShearEfficiency(Vzd)

Return major axis shear efficiency according to AISC-360-16.

Parameters

Vz – required shear strength (minor axis)

setFromDict(dct)

Read member values from a dictionary.

setupULSControlVars(elems, chiN=1.0, chiLT=1.0)
For each element creates the variables

needed to check ultimate limit state criterion to be satisfied.

Parameters

  • elems – elements to define properties on.

  • chiN – axial load reduction reduction factor (default= 1.0).

  • chiLT – lateral buckling reduction factor (default= 1.0).

class materials.astm_aisc.ASTM_materials.ASTMSteel(name=None, fy=250000000.0, fu=400000000.0, gammaM=1.0, Rt=None, Ry=None)

Bases: materials.steel_base.BasicSteel

ASTM structural steel.

Variables

  • name – steel identifier.

  • Rt – Ratio of the expected tensile strength to the specified minimum tensile strength, Fu. See table A3.1 of AISC 341 seismic provisions.

  • Ry – Ratio of the expected yield stress to the specified minimum yield stress, Fy. See table A3.1 of AISC 341 seismic provisions.

getDict()

Put member values in a dictionary.

getEquation7_6_2Factor()

Return the the factor that multiplies the flange width in equation 7.6-2M of AISC 358-16.

getPeakConnectionStrengthFactor()

Return the factor to account for peak connection strength, including strain hardening, local restraint, additional reinforcement and other connection conditions according to clause 2.4.3 (equation 2.4-2) of AISC 358-16.

getYt()

Return the Yt factor to use in clause F13.1 of AISC 360-16 to obtain the strength reduction for members with holes in the tension flange.

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.AnchorBolt(name, steel, diameter, pos3d=None, plateWasher=None)

Bases: connections.steel_connections.bolts.AnchorBase

ASTM anchor bolt according to table 2.2 from the document Base Plate and Anchor Rod Design Second Edition American Institute of Steel Construction, Inc.

Variables

  • name – bolt identifier

  • steel – steel material.

ab_diams = [0.015875, 0.01905, 0.022225, 0.0254, 0.028575, 0.03175, 0.0381, 0.04445, 0.0508, 0.05715, 0.0635, 0.06985, 0.0762, 0.08255, 0.0889, 0.09525, 0.1016]
bearingArea = [0.00044451524, 0.00058451496, 0.0007870952, 0.00096774, 0.0011677396, 0.0014451584, 0.0020193508, 0.0026903172, 0.003451606, 0.0043161204, 0.0052709572, 0.006322568, 0.007354824, 0.008580628, 0.009870948, 0.0112903, 0.012838684]
checkDuctility(h_ef, fc)

Check the ductility of the anchor. If returned value is less or equal than 1.0 then ductility OK.

Parameters

  • h_ef – depth of embedment.

  • fc – concrete strength.

diam_threads_per_inch = [0.0127, 0.0142875, 0.015875, 0.01905, 0.022225, 0.0254, 0.028575, 0.03175, 0.0254, 0.0381, 0.04445, 0.0508, 0.05715, 0.0635, 0.06985, 0.0762, 0.08255, 0.0889, 0.09525, 0.1016]
fBearingArea = <scipy.interpolate._interpolate.interp1d object>
fHoleDiameter = <scipy.interpolate._interpolate.interp1d object>
fThreadsPerInch = <scipy.interpolate._interpolate.interp1d object>
getBearingArea()

Return the bearing area of the anchor according to the table 3.2 of the design guide.

getConcreteBreakoutConePolygon(h_ef)

Return the full breakout cone in tension as per ACI 318-02.

Parameters

h_ef – depth of embedment.

getDesignConcreteBreakoutStrength(h_ef, fc, psi3=1.0, phi=0.7)
Return the design value of the concrete breakout strength

for the anchor group as per ACI 318-02, Appendix D.

Parameters

  • h_ef – depth of embedment.

  • fc – concrete strength.

  • psi3 – 1.25 if the anchor is located in a region of a concrete member where analysis indicates no cracking at service levels, otherwise 1.0

  • phi – resistance factor for concrete breakout (defaults to 0.70).

getDesignPulloutStrength(fc, psi4=1.0, phi=0.7)

Return the design pullout strength of the anchor rod based on the ACI Appendix D provisions (Section D5.3)

Parameters

  • fc – concrete strength.

  • psi4 – 1.4 if the anchor is located in a region of a concrete member where analysis indicates no cracking (f t – f r ) at service levels, otherwise 1.0

getDesignShearStrength(typ='N', phi=0.55)

Return the shear strength of the anchor rod.

Parameters

phi – resistance factor for anchor steel in tension (defaults to 0.55).

getDesignTensileStrength(phi=0.75)

Return the tensile strength of the anchor rod.

Parameters

phi – resistance factor for anchor steel in tension (defaults to 0.75).

getDict()

Put member values in a dictionary.

getNominalConcreteBreakoutStrength(h_ef, fc, psi3=1.0)
Return the nominal value of the concrete breakout strength

for the anchor group as per ACI 318-02, Appendix D.

Parameters

  • h_ef – depth of embedment.

  • fc – concrete strength.

  • psi3 – 1.25 if the anchor is located in a region of a concrete member where analysis indicates no cracking at service levels, otherwise 1.0

getNominalHoleDiameter(rounded=False, prec=3, base=0.005)
Return the hole diameter for the anchor according

to the table 2.3 of the design guide.

Parameters

rounded – if true return the rounded value.

getNominalPulloutStrength(fc, psi4=1.0)

Return the nominal pullout strength of the anchor rod based on the ACI Appendix D provisions (Section D5.3)

Parameters

  • fc – concrete strength.

  • psi4 – 1.4 if the anchor is located in a region of a concrete member where analysis indicates no cracking at service levels, otherwise 1.0

getNominalShearStrength(typ='N')

Return the shear strength of the anchor rod.

getNominalTensileStrength()

Return the tensile strength of the anchor rod.

getNumOfThreadsPerInch()

Return the number of threads per inch.

getPulloutEfficiency(Pu, fc)

Return the pullout efficiency of the bolt.

Parameters

  • Pu – axial load (LRFD).

  • fc – concrete strength.

getShearEffectiveCrossSectionalArea()

Return the effective cross-sectional area of the anchor according to clause R17.5.1.2 of ACI 318R-14.

getTensileStrength()

Return the tensile strength of the anchor rod.

getTensionEffectiveCrossSectionalArea()

Return the effective cross-sectional area of the anchor according to clause R17.4.1.2 of ACI 318R-14.

hDiams = [0.0333375, 0.0396875, 0.0460375, 0.0523875, 0.0587375, 0.06985, 0.08255, 0.08255]
rDiams = [0.01905, 0.022225, 0.0254, 0.03175, 0.0381, 0.04445, 0.0508, 0.0635]
report(outputFile)

Write the anchor specification.

setFromDict(dct)

Read member values from a dictionary.

threads_per_inch = [13, 12, 11, 10, 9, 8, 7, 7, 6, 6, 5, 4.5, 4.5, 4, 4, 4, 4, 4, 4, 4]
class materials.astm_aisc.ASTM_materials.AnchorGroup(steel, diameter, positions, plateWasher=None, postInstalled=False, torqued=False)

Bases: object

Anchor group.

Variables

anchors – anchor list.

getConcreteBreakoutConePolygon(h_ef)
Return breakout cone in tension for the group

as the union of individual cones.

Parameters

h_ef – depth of embedment.

getDesignConcreteBreakoutStrength(h_ef, fc, psi3=1.25, phi=0.7)
Return the design value of the concrete breakout strength

for the anchor group as per ACI 318-02, Appendix D.

Parameters

  • h_ef – depth of embedment.

  • fc – concrete strength.

  • psi3 – 1.25 if the anchor is located in a region of a concrete member where analysis indicates no cracking at service levels, otherwise 1.0

  • phi – resistance factor for concrete breakout (defaults to 0.70).

getDict()

Put member values in a dictionary.

getHoleBlocks(refSys, blockProperties, ownerId)

Return octagons inscribed in the holes.

Parameters

  • refSys – coordinate reference system.

  • blockProperties – labels and attributes to assign to the newly created blocks.

  • ownerId – identifier of the holed surface.

getMinimumSpacing(rodEfficiency=1.0)

Return the minimum spacing according to clause 17.7.1 and 17.7.4 of ACI 318-14.

getNominalConcreteBreakoutStrength(h_ef, fc, psi3=1.25)
Return the concrete breakout strength for the anchor

group as per ACI 318-02, Appendix D.

Parameters

  • h_ef – depth of embedment.

  • fc – concrete strength.

  • psi3 – 1.25 if the anchor is located in a region of a concrete member where analysis indicates no cracking at service levels, otherwise 1.0

getNumberOfBolts()

Return the number of anchors in the group.

getSpacing()

Return the spacing between anchors.

report(outputFile)

Writes anchor group specification.

setFromDict(dct)

Read member values from a dictionary.

setPositions(positions)

Set the anchors positions.

Parameters

positions – list of positions.

class materials.astm_aisc.ASTM_materials.BendingState(Mmax, Ma, Mb, Mc)

Bases: object

Bending moments along the member.

Variables

  • Mmax – absolute value of maximum moment in the unbraced segment.

  • Ma – absolute value of moment at quarter point of the unbraced segment.

  • Mb – absolute value of moment at centerline of the unbraced segment.

  • Mc – absolute value of moment at three-quarter point of the unbraced segment.

getLateralTorsionalBucklingModificationFactor()

Return the lateral-torsional buckling modification factor Cb for non uniform moment diagrams when both ends of the segment are braced according to expression F1-1 of AISC 360-16.

class materials.astm_aisc.ASTM_materials.BoltArray(bolt=<materials.astm_aisc.ASTM_materials.BoltFastener object>, nRows=1, nCols=1, dist=None)

Bases: connections.steel_connections.bolted_plate.BoltArrayBase

Bolt array the AISC/ASTM way.

class materials.astm_aisc.ASTM_materials.BoltFastener(diameter, steelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, pos3d=None)

Bases: connections.steel_connections.bolts.BoltBase

ASTM bolt according to chapter J of AISC 360-16.

Variables

steelType – type of the bolt steel.

bf_diams = [0.012, 0.014, 0.016, 0.02, 0.022, 0.024, 0.027, 0.03, 0.036]
diameterIncrement = 0.002
fOversizeHoleDia = <scipy.interpolate._interpolate.interp1d object>
fStandardHoleDia = <scipy.interpolate._interpolate.interp1d object>
fTabJ3_4M = <scipy.interpolate._interpolate.interp1d object>
getDesignCombinedStrength(V, threadsExcluded=False)
Return the design tensile stress modified to include the

effects of shear stress according to equations J3-3a of AISC 360-16.

Parameters

  • V – shear force on the bolt.

  • threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

getDesignHoleDiameter()

Return the hole diameter to use in net area calculations.

getDesignShearStrength(threadsExcluded=False)
Return the design shear strength of the bolt according

to section J3.6 of of AISC 360-16.

Parameters

threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

getDesignTensileStrength()

Return the design tensile strength of the bolt according to section J3.6 of of AISC 360-16.

getDict()

Put member values in a dictionary.

getGroup()

Return the bolt material strength group according to section J3.1 of AISC 360-16.

getMinDistanceBetweenCenters()

Return the minimum distance between centers of standard, oversized or slotted holes according to section J3.3 of AISC 360-16.

getMinimumEdgeDistance(oversized=False)
Return the minimum edge distance from center of standard

hole to edge of connected part according to toble J3.4M of AISC 360-16.

Parameters

oversized – true if hole is oversized.

getNominalCombinedStrength(V, threadsExcluded=False)
Return the nominal tensile stress modified to include the

effects of shear stress according to equations J3-3a of AISC 360-16.

Parameters

  • V – shear force on the bolt.

  • threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

getNominalHoleDiameter(oversized=False)
Return the minimum distance between centers of standard,

oversized or slotted holes according to table J3.3M of AISC 360-16.

Parameters

oversized – true if hole is oversized.

getNominalShearStrength(threadsExcluded=False)
Return the nominal strength of the fastener according

to table J3.2 of AISC 360-16.

Parameters

threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

getNominalTensileStrength()

Return the nominal strength of the fastener according to table J3.2 of AISC 360-16.

getNumberOfBoltsForShear(shearForce, numberOfRows=1, threadsExcluded=False)
Estimate the number of bolts required for resisting the

shear force.

Parameters

  • shearForce – shear force to be resisted by the bolts.

  • numberOfRows – number of rows of the bolt array.

  • threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

getRecommendedDistanceBetweenCenters()

Return the minimum distance between centers of standard, oversized or slotted holes according to section J3.3 of AISC 360-16.

groupA = ['A325', 'A325M', 'A354BC']
groupB = ['A490', 'A490M', 'A354BD']
groupC = ['F3043', 'F3111']
oversizeHoleDia = [0.016, 0.018, 0.02, 0.024, 0.028, 0.03, 0.035, 0.038]
report(outputFile)

Reports bolt design values.

setFromDict(dct)

Read member values from a dictionary.

standardHoleDia = [0.014, 0.016, 0.018, 0.022, 0.024, 0.027, 0.03, 0.033]
tabJ3_4M = [0.016, 0.018, 0.022, 0.026, 0.028, 0.03, 0.034, 0.038, 0.046]
class materials.astm_aisc.ASTM_materials.BoltedPlate(boltArray=<materials.astm_aisc.ASTM_materials.BoltArray object>, width=None, length=None, thickness=0.01, steelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, notched=False, eccentricity=[[0][0]], doublePlate=False)

Bases: connections.steel_connections.bolted_plate.BoltedPlateBase

Bolted plate the AISC/ASTM way.

Variables

  • Cbearing – 2.4 when deformation at the bolt hole at service load is a design consideration (J3-6a) 3.0 when is not (see J3-6a and J3-6b).

  • longSlottedHoles – true if the holes are of the log slotted type.

getDesignBearingEfficiency(load)

Return the efficiency of the plate with respect to the bolt bearing under the load argument.

getDesignBearingStrength()

Return the design bearing strength at bolt holes according to clause J3.10.1 of AISC 360-16.

getDesignTearoutEfficiency(loadVector)

Return the efficiency of the plate with respect to the bolt tearout under the load argument.

getDesignTearoutStrength(loadDir)
Return the design tearout strength at bolt holes according to

clause J3.10.2 of AISC 360-16.

Parameters

loadDir – direction of the load.

getFilletMaximumLeg(otherThickness)

Return the minimum leg size for a fillet bead according to table J2.4 of AISC 360.

Parameters

otherThickness – thickness of the other part to weld.

getFilletMinimumLeg(otherThickness)

Return the minimum leg size for a fillet bead according to table J2.4 of AISC 360.

Parameters

otherThickness – thickness of the other part to weld.

getGrossSectionYieldingLoad()

Return the load that determines the yielding of the gross section.

getMinThickness(Pd)
Return the minimum thickness of the plate

to resist the force argument.

Parameters

Pd – design value of the force to resist.

getNetArea()

Return the net area of the base plate according to clause B.4.3b of AISC 360-16.

getNetSectionFractureLoad()

Return the load that determines the fracture of the net section.

getNetWidth()

Return the net width of the base plate according to clause B.4.3b of AISC 360-16.

getNominalBearingStrength()

Return the nominal bearing strength at bolt holes according to clause J3.10.(a).(1) of AISC 360-16.

getNominalTearoutStrength(loadDir)
Return the nominal tearout strength at bolt holes according to

clause J3.10.(a).(2) of AISC 360-16.

Parameters

loadDir – direction of the load.

class materials.astm_aisc.ASTM_materials.CHSSShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.CHSSShape

Circular HSS shape with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.CShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.CShape

C shape with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getFlangeMaximumBoltDiameter()

Return the maximum bolt diameter to prevent beam flange tensile rupture according to equation 7.6-2M of AISC 358-16.

getFlangeYieldStrength()

Return the yield strength of the flange.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.ConnectedMember(element)

Bases: connections.steel_connections.connected_members.ConnectedMemberMetaData

Connected member.

getBottomFlangeBoltedPlate(connectionOrigin, column, boltSteel, plateSteel)

Return the blocks corresponding to the bottom flange bolted plate.

Parameters

  • connectionOrigin – origin for the connection.

  • column – column to which the beam is attached to.

  • boltSteel – steel type of the bolts that connect the plate with the flange.

  • plateSteel – steel type of the bolted plate.

getFlangeBoltArray(boltSteel)

Return a suitable bolted array for the beam flange.

Parameters

boltSteel – steel type of the bolts that connect the plate with the flange.

getFlangeBoltedPlateCore(boltSteel, plateSteel)

Return a minimal bolted plate for the beam flange. The length of the plate is just enough to accomodate the bolts and its width is chosen as the maximum of the flange width and the bolted plate minimum width.

Parameters

  • boltSteel – steel type of the bolts that connect the plate with the flange.

  • plateSteel – steel type of the bolted plate.

getShearTab(connectionOrigin, column, boltSteel, plateSteel, shearEfficiency)

Return the blocks corresponding to the shear tab.

Parameters

  • connectionOrigin – origin for the connection.

  • column – column to which the shear tab is attached to.

  • boltSteel – steel type of the bolts that connect the plate with the beam web.

  • plateSteel – steel type of the shear tab.

  • shearEfficiency – ratio between the design shear and the shear strength.

getShearTabBoltArray(shearEfficiency, boltSteelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, threadsExcluded=False)

Return a suitable bolted array for the shear tab.

Parameters

  • shearEfficiency – ratio between the design shear and the shear strength.

  • boltSteelType – bolt steel type.

getShearTabCore(boltSteel, plateSteel, shearEfficiency)

Return a minimal shear tab. The length of the plate is just enough to accomodate the bolts and its width is chosen as three inches.

Parameters

  • boltSteel – steel type of the bolts that connect the plate with the flange.

  • plateSteel – steel type of the bolted plate.

  • shearEfficiency – ratio between the design shear and the shear strength.

getTopFlangeBoltedPlate(connectionOrigin, column, boltSteel, plateSteel)

Return the top flange bolted plate.

Parameters

  • connectionOrigin – origin for the connection.

  • column – column to which the beam is attached to.

  • boltSteel – steel type of the bolts that connect the plate with the flange.

  • plateSteel – steel type of the bolted plate.

class materials.astm_aisc.ASTM_materials.FilletWeld(legSize, length, fillerMetal=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, throat=None, endLoaded=False, lapJoint=False)

Bases: object

Fillet weld according to chapter J, section J2, of AISC 360-16,

Variables

  • legSize – weld size (leg dimension or actual throat) (t)

  • fillerMetal – weld metal (defaults to E7018)

  • throat – weld throat thickness (a) (= shortest distance from the root to the face of the diagrammatic weld) (defaults to None, in which case it’s calculated for 90º)

  • endLoaded –

    True if the load is trasferred at the end of the weld (e.g. lap joints with longitudinal welds, as do bearing

    stiffeners. Welds subject to shear loading due to bending forces are not included in end-loaded applications) Defaults to False

  • lapJoint – True if lap joint (defaults to False)

checkWeldDimensions(t1, t2)

Perform the AISC verifications of the weld dimensions and return its strength

Parameters

t2 (t1,) – thicknesses of the two steel sheets to weld

getCapacityFactor(Fpar_d, Fperp_d, t1=None, t2=None)

Return the weld capacity factor. If the thicknesses of the plates to be welded are provided, the dimensions of the weld are also checked.

Parameters

  • Fpar_d – design required force in direction parallel to the weld longitudinal axis

  • Fperp_d – design required force in direction perpendicular to the weld longitudinal axis

  • t2 (t1,) – thickness of the two steel sheets to be welded

getDesignStrength(Fpar=None, Fperp=None, theta=0)

Return the design strength of the weld (sect. J2.4 of AISC-360) If acting forces parallel and perpendicular to the weld longitudinal axis are defined, the angle between the the line of action of the required force and the weld longitudinal axis is calculated based on those forces. Otherwise, angle theta (degrees) is used.

Parameters

  • Fpar – required force in direction parallel to the weld longitudinal axis

  • Fperp – required force in direction perpendicular to the weld longitudinal axis

  • theta – angle between the line of action of the required force and the weld longitudinal axis (in degrees) (defaults to 0º)

getEffectiveArea()

Return the effective area of the weld (Sect. J2.2.2a of AISC-360)

getEffectiveLength()

Return the effective length of the weld (Sect J2.2.2b.(d) of AISC-360)

getMaximumSize(t1, t2)

Return the maximum leg size of the fillet weld that can be used to weld two sheets of thicknesses t1 and t2 (Sect. J2.2b of AISC 360)

getMinLength()

Return the minimum length of the fillet weld (Sect. J2.2b.(c) of AISC-360)

getMinimumSize(t1, t2)

Return the minimum leg size of the fillet weld that can be used to weld two sheets of thicknesses t1 and t2 (Sect. J2.4 of AISC-360)

getNominalStrength(Fpar=None, Fperp=None, theta=0)

Return the nominal strength of the weld (sect. J2.4 of AISC-360) If acting forces parallel and perpendicular to the weld longitudinal axis are defined, the angle between the the line of action of the required force and the weld longitudinal axis is calculated based on those forces. Otherwise, angle theta (degrees) is used.

Parameters

  • Fpar – required force in direction parallel to the weld longitudinal axis

  • Fperp – required force in direction perpendicular to the weld longitudinal axis

  • theta – angle between the line of action of the required force and the weld longitudinal axis (in degrees) (defaults to 0º)

class materials.astm_aisc.ASTM_materials.FinPlate(boltArray, width=None, length=None, thickness=0.01, steelType=None, notched=False, eccentricity=[[0][0]])

Bases: materials.astm_aisc.ASTM_materials.BoltedPlate

Fin plate the AISC/ASTM way.

getDesignBlockShearEfficiency(shearVector, Ubs=0.5)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

  • shearVector – 2D shear load vector.

  • Ubs – Reduction coefficient, used in calculating block shear rupture strength.

getDesignBlockShearStrength(shearVector, Ubs=0.5)
Return the design shear strength of the plate according to

clause J.4.3 of AISC 360-16.

Parameters

  • shearVector – 2D shear load vector.

  • Ubs – Reduction coefficient, used in calculating block shear rupture strength.

getDesignEfficiency(loadVector, Ubs=0.5)
Return the efficiency of the fin plate under the load

argument. Checks bolt shear, bolt bearing and tearout. Don’t checks weld shear, shear rupture an block shear rupture (those will be checked using the CBFEM model).

Parameters

  • loadVector – 2D load vector.

  • Ubs – Reduction coefficient, used in calculating block shear rupture strength.

getDesignShearEfficiency(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

getDesignShearRuptureStrength(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

getDesignShearStrength(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

getDesignShearYieldingStrength(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

getFilletWeldLegSize()

Return the conventional leg size for two fillet welds attaching the plate to the main member.

Based on the document: Single-Plate Shear Connection Design to Meet Structural Integrity Requirements. LOUIS F. GESCHWINDNER and KURT D. GUSTAFSON. 2010

getGrossAreaSubjectedToBlockShear(loadDir)
Return the net area the gross area subjected to tension used

in the calculation of the block shear strength.

Parameters

loadDir – direction of the load.

getGrossAreaSubjectedToShear(shearVector)

Return the gross area of the plate subjected to shear.

Parameters

shearVector – 2D shear load vector.

getNetAreaSubjectedToBlockShear(loadDir)
Return the net area the net area subjected to tension used

in the calculation of the block shear strength.

Parameters

loadDir – direction of the load.

getNetAreaSubjectedToBlockTension(shearVector)
Return the net area the net area subjected to tension used

in the calculation of the block shear strength.

Parameters

shearVector – 2D shear load vector.

getNetAreaSubjectedToShear(Agv, shearVector)

Return the net area of the plate subjected to shear.

Parameters

  • Agv – gross area of the plate subjected to shear.

  • shearVector – 2D shear load vector.

getNominalBlockShearStrength(shearVector, Ubs=0.5)
Return the nominal shear strength of the plate according to

clause J.4.3 of AISC 360-16.

Parameters

  • shearVector – 2D shear load vector.

  • Ubs – Reduction coefficient, used in calculating block shear rupture strength.

getNominalShearRuptureStrength(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

getNominalShearYieldingStrength(shearVector)
Return the design shear strength of the plate according to

clause J.4.2 of AISC 360-16.

Parameters

shearVector – 2D shear load vector.

class materials.astm_aisc.ASTM_materials.GussetPlate(boltedPlateTemplate, gussetTip, halfChamfer, ijkVectors)

Bases: connections.steel_connections.gusset_plate.GussetPlate

Gusset plates according to AISC 360-16.

getFilletMaximumLeg(otherThickness)

Return the minimum leg size for a fillet bead according to table J2.4 of AISC 360.

Parameters

otherThickness – thickness of the other part to weld.

getFilletMinimumLeg(otherThickness)

Return the minimum leg size for a fillet bead according to table J2.4 of AISC 360.

Parameters

otherThickness – thickness of the other part to weld.

class materials.astm_aisc.ASTM_materials.HFSHSShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.HFSHSShape

BS EN 10210-2: 2006 steel shapes with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.HSSShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.HSSShape

Rectangular HSS shape with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.IShape(bf, tf, tw, hw, steel=None, name='')

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.IShape

I shape with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.LShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.LShape

Single angle shape with ASTM/AISC verification routines.

getBiaxialBendingEfficiency(Nd, Myd, Mzd, Vyd=0.0, chiN=1.0, chiLT=1.0)
Return biaxial bending efficiency according to section H2

of AISC-360-16.

Parameters

  • Nd – required axial strength.

  • Mzd – required bending strength (major axis).

  • Vyd – required shear strength (major axis)

  • chiN – axial load reduction reduction factor (default= 1.0).

  • chiLT – lateral buckling reduction factor (default= 1.0).

getBiaxialBendingEfficiencyPrincipalAxes(Nd, MZ, MW, chiN=1.0, chiLT=1.0)
Return biaxial bending efficiency according to section H2

of AISC-360-16.

Parameters

  • Nd – required axial strength.

  • MZ – required shear strength (minor axis)

  • MW – required bending strength (major axis).

  • chiN – axial load reduction reduction factor (default= 1.0).

  • chiLT – lateral buckling reduction factor (default= 1.0).

getCriticalStressE(effectiveLengthY, effectiveLengthZ, Fe)
Return the critical stress of the member according

to equations E3-2 and E3-3 of AISC-360-16.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

  • Fe – flexural or torsional elastic buckling stress.

getDict()

Put member values in a dictionary.

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.MemberConnection(L, rotI='free', transI='fixed', rotJ='free', transJ='fixed')

Bases: materials.member_base.MemberConnection

Member length and connections

Variables

  • L – member length.

  • Lb – Length between points that are either braced against lateral displacement of compression flange or braced against twist of the cross section.

  • rotI – fixity of the rotation at member start.

  • transI – fixity of the translation at member start.

  • rotJ – fixity of the rotation at member end.

  • transJ – fixity of the translation at member end.

getLateralTorsionalBucklingModificationFactor(bendingState)

Return the lateral-torsional buckling modification factor Cb for non uniform moment diagrams when both ends of the segment are braced according to expression F1-1 of AISC 360-16.

Parameters

  • Mmax – absolute value of maximum moment in the unbraced segment.

  • Ma – absolute value of moment at quarter point of the unbraced segment.

  • Mb – absolute value of moment at centerline of the unbraced segment.

  • Mc – absolute value of moment at three-quarter point of the unbraced segment.

class materials.astm_aisc.ASTM_materials.MemberWithEndConnections(shape, connection)

Bases: object

Steel member with end connections with ASTM/AISC verification routines.

getCapacityFactor(Nd, Myd, Mzd, gammaC, bendingStateY, bendingStateZ, AfgAfnRatio=1.0)
Return the capacity factor according to section

H1 of AISC 360-16.

Parameters

  • Lb – Length between points that are either braced against lateral displacement of compression flange or braced against twist of the cross section.

  • Nd – design value for the axial load (negative for compression).

  • Mzd – design value for the bending moment around z axis.

  • Myd – design value for the bending moment around z axis.

  • bendingStateY – y bending moments along the member.

  • bendingStateZ – z bending moments along the member.

  • AfgAfnRatio – value of gross area of tension flange calculated in accordance with the provisions of Section B4.3a of AISC 360-16 divided by the net area of tension flange calculated in accordance with the provisions of Section B4.3b.

getCompressiveCriticalStress()

Return the compressive critical stress of the member.

getCriticalStress()

Return the critical stress as definded in section E7 of AISC 360-16.

getEffectiveLength()

Return the member effective length according to section E2 of AISC 360-16.

getElasticBucklingStress()

Return the elastic buckling stress of the member.

getNominalCompressiveStrength()

Return the nominal compressive strength according to section E7 of AISC 360-16.

getSlendernessRatio()

Return the slenderness ratio of the member.

getYLateralTorsionalBucklingFlexuralStrength(bendingState)

Return the maximum flexural strength due to web local buckling according to expressions F7-10 to F7-11 of AISC 360-16

Parameters

bendingState – bending moments along the member.

getYNominalFlexuralStrength(bendingState)

Return the nominal flexural strength around z axis.

Parameters

bendingState – bending moments along the member.

getZLateralTorsionalBucklingFlexuralStrength(bendingState)

Return the maximum flexural strength due to web local buckling according to expressions F7-10 to F7-11 of AISC 360-16

Parameters

bendingState – bending moments along the member.

getZNominalFlexuralStrength(bendingState, AfgAfnRatio=1.0)
Return the nominal flexural strength

around z axis.

Parameters

  • bendingState – bending moments along the member.

  • AfgAfnRatio – value of gross area of tension flange calculated in accordance with the provisions of Section B4.3a of AISC 360-16 divided by the net area of tension flange calculated in accordance with the provisions of Section B4.3b.

class materials.astm_aisc.ASTM_materials.SimpleLShape(steel, name)

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.SimpleLShape

Single angle shape with simplified ASTM/AISC verification routines.

getCriticalStressE(effectiveLengthY, effectiveLengthZ, Fe)
Return the critical stress of the member according

to equations E3-2 and E3-3 of AISC-360-16.

Parameters

  • effectiveLengthY – effective length of member (minor axis).

  • effectiveLengthZ – effective length of member (major axis).

  • Fe – flexural or torsional elastic buckling stress.

getDict()

Put member values in a dictionary.

setFromDict(dct)

Read member values from a dictionary.

class materials.astm_aisc.ASTM_materials.SquarePlateWasher(bolt, side=None, thickness=None, steelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>)

Bases: connections.steel_connections.square_plate_washer.SquarePlateWasher

Class for AISC plate washers.

class materials.astm_aisc.ASTM_materials.WShape(steel=None, name='')

Bases: materials.astm_aisc.ASTM_materials.ASTMShape, materials.sections.structural_shapes.aisc_metric_shapes.WShape

W shape with ASTM/AISC verification routines.

getDict()

Put member values in a dictionary.

getTorsionalElasticBucklingStress(effectiveLengthX)
Return the torsional or flexural-torsional elastic buckling stress

of the member according to equations E4-2, E4-3 and E4-4 of AISC-360-16.

Parameters

effectiveLengthX – effective length of member (torsion).

setFromDict(dct)

Read member values from a dictionary.

materials.astm_aisc.ASTM_materials.getBoltForHole(holeDiameter, boltSteelType=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, tol=0.0005)
Return the bolt that fits in the hole diameter

argument.

Parameters

  • holeDiameter – diameter of the hole.

  • tol – tolerance (defaults to 0.5 mm).

materials.astm_aisc.ASTM_materials.getBoltForShear(shearForce, numberOfBolts, threadsExcluded=False)
Estimate the diameter of the bolts required for resisting the

shear force.

Parameters

  • shearForce – shear force to be resisted by the bolts.

  • numberOfBolts – number of bolts in the bolt array.

  • threadsExcluded – true if threads and transition area of shank are excluded from the shear plane.

materials.astm_aisc.ASTM_materials.getCrossSections(steelShapes, steel_W=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, steel_C=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, steel_L=<materials.astm_aisc.ASTM_materials.ASTMSteel object>, steel_HSS=<materials.astm_aisc.ASTM_materials.ASTMSteel object>)
Return a dictionary containing the cross section definition for each

of the structural shapes in the steelShapes arguments.

Parameters

  • steelShapes – string identifiers of the steel shapes.

  • steel_W – steel for the wide flange steel shapes (defaults to A992).

  • steel_C – steel for the channel steel shapes (defaults to A36).

  • steel_L – steel for the single-angle steel shapes (defaults to A36).

  • steel_HSS – steel for the hollow structural steel shapes (defaults to A500).

materials.astm_aisc.ASTM_materials.getFilletWeldMaximumLeg(t)

Return the maximum leg size for a fillet bead that welds a sheet of thickness t according to section J2.2b of AISC 360.

Parameters

t – Sheet thickness.

materials.astm_aisc.ASTM_materials.getFilletWeldMaximumLegSheets(t1, t2)

Return the maximum leg size which can be used to weld two sheets according to section J2.2b of AISC 360.

Parameters

  • t1 – Thickness of sheet 1.

  • t2 – Thickness of sheet 2.

materials.astm_aisc.ASTM_materials.getFilletWeldMinimumLeg(t)

Return the minimum leg size for a fillet bead that welds a sheet of thickness t according to table J2.4 of AISC 360.

Parameters

t – Sheet thickness.

materials.astm_aisc.ASTM_materials.getFilletWeldMinimumLegSheets(t1, t2)

Return the minimum leg size which can be used to weld two sheets according to table J2.4 of AISC 360.

Parameters

  • t1 – Thickness of sheet 1.

  • t2 – Thickness of sheet 2.

materials.astm_aisc.ASTM_materials.getSquareAnchorGroup(steel, diameter, squareSide, xCenter=0.0, yCenter=0.0)

Return four anchors in the corners of the square.

Parameters

  • steel – steel material.

  • diameter – bolt diameter.

  • squareSide – side of the square.

  • xCenter – x coordinate of the square center.

  • yCenter – y coordinate of the square center.

materials.astm_aisc.ASTM_materials.readBoltedPlateFromJSONFile(inputFileName)

Read bolted plate object from a JSON file.