Skip to main content

SteelPy

steelpy is a library that acts a database for AISC steel shapes for easy use in structural calculations and applications. The library includes W, M, S, HP, WT, MT, ST, Pipe, HSS, L, and Double L profiles.

Contents

Installation

Install using pip:

pip install steelpy

Usage

To use the steelpy library, first import the module

from steelpy import aisc

The library includes W, M, S, HP, WT, MT, ST, Pipe, HSS, L, and Double L profiles. To access a library of shapes, simply use dot notation for the group of profiles:

aisc.C_shapes
aisc.DBL_L_shapes
aisc.HP_shapes
aisc.HSS_R_shapes
aisc.HSS_shapes
aisc.L_shapes
aisc.M_shapes
aisc.MC_shapes
aisc.MT_shapes
aisc.PIPE_shapes
aisc.S_shapes
aisc.ST_shapes
aisc.W_shapes
aisc.WT_shapes

From there, specific sections and properties are queried in a similar manner:

beam = aisc.W_shapes.W12X26
Fy = 50
Aw = beam.d * beam.tw
Cv = 1.0
Vn = 0.6*Fy*Aw*Cv

Sections with fractions, hyphens or decimal points in their names are queried by replacing each with underscore:

aisc.C_shapes.C12X20_7
aisc.L_shapes.L4X4X1_4
aisc.W_shapes.W6X8_5

Values are consistent with the AISC Steel Construction Manual, 16th Ed. and use the imperial system (inches, lbs). .csv files for each library of shapes is saved in steelpy > shape files and can be referenced for the available shape profiles and associated properties.

Filter Method

The filter method allows you to filter the sections of a collection based on specified criteria, maximum values, minimum values, or a combination thereof. Additionally, you can sort the filtered result by a specified property.

Parameters

  • criteria: A dictionary where keys are the properties to filter by, and values are dictionaries with 'min' and/or 'max' keys specifying the minimum and maximum values for each property.
  • sort_by: (Optional) The attribute by which to sort the filtered result. Defaults to sort by weight.

Return Value

A dictionary containing all Section objects that meet the provided filtering criteria, sorted by the specified attribute if sort_by is provided.

Usage Example

# Example usage 1: Filter sections based on a single property with a minimum value and sort the results by another property
filtered_result = aisc.W_shapes.filter({'Zx': {'min': 150}}, sort_by='Iy')

# Example usage 2: Filter sections based on multiple properties with different maximum and minimum values
filtered_result = aisc.W_shapes.filter({'d': {'min': 8, 'max': 12.3}, 'Ix': {'max': 100}})

# Access the filtered sections in example 2
for section_name, section_object in filtered_result.items():
    print(f"Section: {section_name}, d: {section_object.d}, Ix: {section_object.Ix}")

# Expected output:
# Section: W12X16, d: 12.0, Ix: 103.0
# Section: W12X19, d: 12.2, Ix: 130.0
# Section: W12X22, d: 12.3, Ix: 156.0
# ...

Property Table

Attribute C DBL_L HP HSS_R HSS L M MC MT PIPE S ST W WT
weight ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
area ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
d ✓ ✓ ✓ _ _ ✓ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
bf ✓ _ ✓ _ _ _ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
tw ✓ _ ✓ _ _ _ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
tf ✓ _ ✓ _ _ _ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
k ✓ _ ✓ _ _ ✓ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
x ✓ _ _ _ _ ✓ _ ✓ _ _ _ _ _ _
eo ✓ _ _ _ _ _ _ ✓ _ _ _ _ _ _
xp ✓ _ _ _ _ ✓ _ ✓ _ _ _ _ _ _
Ix ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Zx ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Sx ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
rx ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Iy ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Zy ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Sy ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
ry ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
J ✓ _ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓ ✓
Cw ✓ _ ✓ _ _ ✓ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
Wno ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
Sw1 ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
Sw2 ✓ _ _ _ _ _ _ ✓ _ _ _ _ _ _
Sw3 ✓ _ _ _ _ _ _ ✓ _ _ _ _ _ _
Qf ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
Qw ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
ro ✓ ✓ _ _ _ ✓ _ ✓ ✓ _ _ ✓ _ ✓
H ✓ ✓ _ _ ✓ ✓ _ ✓ ✓ _ _ ✓ _ ✓
rts ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
ho ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ _
PA ✓ _ ✓ _ _ ✓ ✓ ✓ _ _ ✓ _ ✓ ✓
PB ✓ _ ✓ _ _ ✓ ✓ ✓ _ _ ✓ _ ✓ ✓
PC ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ ✓
PD ✓ _ ✓ _ _ _ ✓ ✓ _ _ ✓ _ ✓ ✓
T ✓ ✓ ✓ _ _ ✓ ✓ ✓ _ _ ✓ _ ✓ _
WGi ✓ _ ✓ _ _ _ ✓ ✓ ✓ _ ✓ ✓ ✓ ✓
b _ ✓ _ _ _ ✓ _ _ _ _ _ _ _ _
y _ ✓ _ _ _ ✓ _ _ ✓ _ _ ✓ _ ✓
yp _ ✓ _ _ _ ✓ _ _ ✓ _ _ ✓ _ ✓
k1 _ _ ✓ _ _ _ ✓ _ _ _ _ _ ✓ _
OD _ _ _ ✓ _ _ _ _ _ ✓ _ _ _ _
tnom _ _ _ ✓ ✓ _ _ _ _ ✓ _ _ _ _
tdes _ _ _ ✓ ✓ _ _ _ _ ✓ _ _ _ _
C _ _ _ ✓ ✓ _ _ _ _ _ _ _ _ _
Ht _ _ _ _ ✓ _ _ _ _ _ _ _ _ _
Iz _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
rz _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
Sz _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
tan_a _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
Iw _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
zA _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
zB _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
zC _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
wA _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
wB _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
wC _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SwA _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SwB _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SwC _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SzA _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SzB _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
SzC _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
PA2 _ _ _ _ _ ✓ _ _ _ _ _ _ _ _
ID _ _ _ _ _ _ _ _ _ ✓ _ _ _ _
WGo _ _ _ _ _ _ _ _ _ _ _ _ ✓ ✓

Property Descriptions

Attribute Description
weight Nominal weight, lb/ft
area Cross-sectional area, in.2
d Overall depth of member, or width of shorter leg for angles, or width of the outstanding legs of long legs back-to-back double angles, or the width of the back-to-back legs of short legs back-to-back double angles, in.
bf Width of flange, in.
tw Thickness of web, in.
tf Thickness of flange, in.
k Distance from outer face of flange to web toe of fillet used for design, in.
x Horizontal distance from designated edge of member, as defined in the AISC Steel Construction Manual Part 1, to center of gravity of member, in.
eo Horizontal distance from designated edge of member, as defined in the AISC Steel Construction Manual Part 1, to shear center of member, in.
xp Horizontal distance from designated edge of member, as defined in the AISC Steel Construction Manual Part 1, to plastic neutral axis of member, in.
Ix Moment of inertia about the x-axis, in.4
Zx Plastic section modulus about the x-axis, in.3
Sx Elastic section modulus about the x-axis, in.3
rx Radius of gyration about the x-axis, in.
Iy Moment of inertia about the y-axis, in.4
Zy Plastic section modulus about the y-axis, in.3
Sy Elastic section modulus about the y-axis, in.3
ry Radius of gyration about the y-axis , in.
J Torsional constant, in.4
Cw Warping constant, in.6
Wno Normalized warping function, as used in Design Guide 9, in.2
Sw1 Warping statical moment at point 1 on cross section, as used in AISC Design Guide 9 and shown in Figures 1 and 2, in.4
Sw2 Warping statical moment at point 2 on cross section, as used in AISC Design Guide 9 and shown in Figure 2, in.4
Sw3 Warping statical moment at point 3 on cross section, as used in AISC Design Guide 9 and shown in Figure 2, in.4
Qf Statical moment for a point in the flange directly above the vertical edge of the web, as used in AISC Design Guide 9, in.3
Qw Statical moment for a point at mid-depth of the cross section, as used in AISC Design Guide 9, in.3
ro Polar radius of gyration about the shear center, in.
H Depth of the flat wall of square HSS or longer flat wall of rectangular HSS, in.
rts Effective radius of gyration, in.
ho Distance between the flange centroids, in.
PA Shape perimeter minus one flange surface , as used in Design Guide 19, in.
PB Shape perimeter, as used in AISC Design Guide 19, in.
PC Box perimeter minus one flange surface, as used in Design Guide 19, in.
PD Box perimeter, as used in AISC Design Guide 19, in.
T Thickness of angle leg, in.
WGi The workable gage for the inner fastener holes in the flange that provides for entering and tightening clearances and edge distance and spacing requirements. The actual size, combination, and orientation of fastener components should be compared with the geometry of the cross section to ensure compatibility. See AISC Manual Part 1 for additional information, in.
b Overall width of square HSS or shorter wall of rectangular HSS, in.
y Vertical distance from designated edge of member, as defined in the AISC Steel Construction Manual Part 1, to center of gravity of member, in.
yp Vertical distance from designated edge of member, as defined in the AISC Steel Construction Manual Part 1, to plastic neutral axis of member, in.
k1 Distance from web center line to flange toe of fillet used for detailing, in.
OD Outside diameter of round HSS or pipe, in.
tnom Nominal thickness of HSS and pipe wall, in.
tdes Design thickness of HSS and pipe wall, in.
C HSS torsional constant, in.3
Ht Overall depth of square HSS or longer wall of rectangular HSS, in.
Iz Moment of inertia about the z-axis, in.4
rz Radius of gyration about the z-axis, in.
Sz Elastic section modulus about the z-axis, in.3 . For single angles, see SzA, SzB, and SzC.
tan_a Tangent of the angle between the y-y and z-z axes for single angles, where a is shown in Figure 3
Iw Moment of inertia about the w-axis for single angles, in.4
zA Distance from point A to center of gravity along z-axis, as shown in Figure 3, in.
zB Distance from point B to center of gravity along z-axis, as shown in Figure 3, in.
zC Distance from point C to center of gravity along z-axis, as shown in Figure 3, in.
wA Distance from point A to center of gravity along w-axis, as shown in Figure 3, in.
wB Distance from point B to center of gravity along w-axis, as shown in Figure 3, in.
wC Distance from point C to center of gravity along w-axis, as shown in Figure 3, in.
SwA Elastic section modulus about the w-axis at point A on cross section, as shown in Figure 3, in.3
SwB Elastic section modulus about the w-axis at point B on cross section, as shown in Figure 3, in.3
SwC Elastic section modulus about the w-axis at point C on cross section, as shown in Figure 3, in.3
SzA Elastic section modulus about the z-axis at point A on cross section, as shown in Figure 3, in.3
SzB Elastic section modulus about the z-axis at point B on cross section, as shown in Figure 3, in.3
SzC Elastic section modulus about the z-axis at point C on cross section, as shown in Figure 3, in.3
PA2 Single angle shape perimeter minus long leg surface, as used in AISC Design Guide 19, in.
ID Inside diameter of pipe, in.
WGo The bolt spacing between inner and outer fastener holes when the workable gage is compatible with four holes across the flange. See AISC Manual Part 1 for additional information, in.

Metadata

Release files for steelpy 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for steelpy 1.1.1
File Size Uploaded
steelpy-1.1.1.tar.gz 109.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for steelpy 1.1.1
File Interpreter ABI Platform
steelpy-1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 218.0 kB

Release files / steelpy-1.1.1.tar.gz

Download URL steelpy-1.1.1.tar.gz
Size 109.3 kB
Tags Source
SHA-256 checksum
How to use checksums
8ea3236f5bb2fb530001f3d736b16d50457b691debec6a6a791b75985be3f817
BLAKE2b-256 checksum
How to use checksums
c9909ede68cfcc4bd9cb1b68abae7ef328b9547a311eeb6a1ae92fda1d0d0496
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.2 CPython/3.12.0 Windows/11

Release files / steelpy-1.1.1-py3-none-any.whl

Download URL steelpy-1.1.1-py3-none-any.whl
Size 108.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5710a7ff7d7a7eb0ca52a00699851aaa962cd137d5f9492709e19e0aec85670a
BLAKE2b-256 checksum
How to use checksums
b034648794eed665b024ee071a94042f34ce7fb9141d067ce58efa961dddf9eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.2 CPython/3.12.0 Windows/11

Release history Release notifications | RSS feed

This release

1.1.1 This release

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page