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.

Parem effectiveLengthZ:
Parameters:	effectiveLengthY – effective length of member (minor axis).
	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.

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(sectionClass, Vy)¶

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

Parameters:	sectionClass – dummy argument used for compatibility. Vy – required shear strength (major axis)

getZBendingEfficiency(Nd, Mzd, Vyd=0.0, chiN=1.0, chiLT=1.0, sectionClass=None)¶

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). sectionClass – dummy argument used for compatibility.

getZShearEfficiency(sectionClass, Vz)¶

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

Parameters:	sectionClass – dummy argument used for compatibility. Vz – required shear strength (minor axis)

setFromDict(dct)¶: Read member values from a dictionary.

setupULSControlVars(elems, sectionClass=1, chiN=1.0, chiLT=1.0)¶

For each element creates the variables needed to check ultimate limit state criterion to be satisfied.

Parameters:	sectionClass – dummy argument used for compatibility. 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.

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.

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.

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.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.

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.

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.

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

Bases: materials.steel_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.

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.

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.

ASTM-AISC materials¶

ASTM-AISC materials¶

Table of Contents

Previous topic

Next topic

This Page