Section Properties#

class efficalc.sections.AiscAngle(A: float, AISC_name: str, Cw: float, EDI_Std_Nomenclature: str, Iw: float, Ix: float, Iy: float, Iz: float, J: float, PA: float, PA2: float, PB: float, SwA: float, SwB: float, SwC: float, Sx: float, Sy: float, Sz: float, SzA: float, SzB: float, SzC: float, T_F: str, Type: str, W: float, Zx: float, Zy: float, b: float, b_t: float, d: float, kdes: float, kdet: float, ro: float, rx: float, ry: float, rz: float, t: float, tana: float, wA: float, wB: float, wC: float, x: float, xp: float, y: float, yp: float, zA: float, zB: float, zC: float)#

This is a dataclass containing the properties of an AISC Angle section. Properties follow the AISC shapes database.

Parameters:

A (float) – The section area (in^2)
AISC_name (str) – The name of the AISC section
Cw (float) – The warping constant (in^6)
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
Iw (float) – The moment of inertia about the w-axis (in^4)
Ix (float) – The moment of inertia about the x-axis (in^4)
Iy (float) – The moment of inertia about the y-axis (in^4)
Iz (float) – The moment of inertia about the z-axis (in^4)
J (float) – The torsional constant (in^4)
PA (float) – The shape perimeter minus one flange surface (in)
PA2 (float) – The single angle shape perimeter minus long leg surface (in)
PB (float) – The shape perimeter for AISC Design Guide 19 (in)
SwA (float) – The elastic section modulus about the w-axis at point A (in^3)
SwB (float) – The elastic section modulus about the w-axis at point B (in^3)
SwC (float) – The elastic section modulus about the w-axis at point C (in^3)
Sx (float) – The elastic section modulus about the x-axis (in^3)
Sy (float) – The elastic section modulus about the y-axis (in^3)
Sz (float) – The elastic section modulus about the z-axis (in^3)
SzA (float) – The elastic section modulus about the z-axis at point A (in^3)
SzB (float) – The elastic section modulus about the z-axis at point B (in^3)
SzC (float) – The elastic section modulus about the z-axis at point C (in^3)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – The nominal section weight (lb/ft)
Zx (float) – The plastic section modulus about the x-axis (in^3)
Zy (float) – The plastic section modulus about the y-axis (in^3)
b (float) – The width of the longer angle leg (in)
b_t (float) – The slenderness ratio, b/t
d (float) – The width of the shorter leg (in)
kdes (float) – Distance from outer face of flange to web toe of fillet used for design (in)
kdet (float) – Distance from outer face of flange to web toe of fillet used for detailing (in)
ro (float) – Polar radius of gyration about the shear center (in)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
rz (float) – Radius of gyration about the z-axis (in)
t (float) – Thickness of the angle leg (in)
tana (float) – Tangent of the angle between the y-y and z-z axes for single angles
wA (float) – Distance from point A to center of gravity along the w-axis (in)
wB (float) – Distance from point B to center of gravity along the w-axis (in)
wC (float) – Distance from point C to center of gravity along the w-axis (in)
x (float) – Horizontal distance from designated edge of member to center of gravity of member (in)
xp (float) – Horizontal distance from designated edge of member to plastic neutral axis of member (in)
y (float) – Vertical distance from designated edge of member to center of gravity of member (in)
yp (float) – Vertical distance from designated edge of member to plastic neutral axis of member (in)
zA (float) – Distance from point A to center of gravity along the z-axis (in)
zB (float) – Distance from point B to center of gravity along the z-axis (in)
zC (float) – Distance from point C to center of gravity along the z-axis (in)

class efficalc.sections.AiscChannel(A: float, AISC_name: str, Cw: float, EDI_Std_Nomenclature: str, H: float, Ix: float, Iy: float, J: float, PA: float, PB: float, PC: float, PD: float, Qf: float, Qw: float, Sw1: float, Sw2: float, Sw3: float, Sx: float, Sy: float, T: float, T_F: str, Type: str, W: float, WGi: float, Wno: float, Zx: float, Zy: float, bf: float, bfdet: float, b_t: float, d: float, ddet: float, eo: float, h_tw: float, ho: float, kdes: float, kdet: float, ro: float, rts: float, rx: float, ry: float, tf: float, tfdet: float, tw: float, twdet: float, twdet_2: float, x: float, xp: float)#

This is a dataclass containing the properties of an AISC Channel section. Properties follow the AISC shapes database.

Parameters:

A (float) – The cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
Cw (float) – The warping constant (in^6)
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
H (float) – Flexural constant
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
J (float) – Torsional constant (in^4)
PA (float) – Shape perimeter minus one flange surface (in)
PB (float) – Shape perimeter, as used in AISC Design Guide 19 (in)
PC (float) – Box perimeter minus one flange surface, as used in Design Guide 19 (in)
PD (float) – Box perimeter, as used in AISC Design Guide 19 (in)
Qf (float) – Statical moment for a point in the flange directly above the vertical edge of the web (in^3)
Qw (float) – Statical moment for a point at mid-depth of the cross section (in^3)
Sw1 (float) – Warping statical moment at point 1 on cross section (in^4)
Sw2 (float) – Warping statical moment at point 2 on cross section (in^4)
Sw3 (float) – Warping statical moment at point 3 on cross section (in^4)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T (float) – Distance between web toes of fillets at top and bottom of web (in)
T_F (str) – Indicates if there is a special note for the shape (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
WGi (float) – The workable gage for the inner fastener holes in the flange (in)
Wno (float) – Normalized warping function (in^2)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
bf (float) – Width of flange (in)
bfdet (float) – Detailing value of flange width (in)
b_t (float) – Slenderness ratio for angles and channel flange, b/t
d (float) – Overall depth of member (in)
ddet (float) – Detailing value of member depth (in)
eo (float) – Horizontal distance to shear center of member (in)
h_tw (float) – Slenderness ratio for web, h/tw
ho (float) – Distance between the flange centroids (in)
kdes (float) – Distance from outer face of flange to web toe of fillet for design (in)
kdet (float) – Distance from outer face of flange to web toe of fillet for detailing (in)
ro (float) – Polar radius of gyration about the shear center (in)
rts (float) – Effective radius of gyration (in)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
tf (float) – Thickness of flange (in)
tfdet (float) – Detailing value of flange thickness (in)
tw (float) – Thickness of web (in)
twdet (float) – Detailing value of web thickness (in)
twdet_2 (float) – Detailing value of twdet/2 (in)
x (float) – Horizontal distance to center of gravity of member (in)
xp (float) – Horizontal distance to plastic neutral axis of member (in)

class efficalc.sections.AiscCircular(A: float, AISC_name: str, C: float, D_t: float, EDI_Std_Nomenclature: str, Ix: float, Iy: float, J: float, OD: float, Sx: float, Sy: float, T_F: str, Type: str, W: float, Zx: float, Zy: float, rx: float, ry: float, tdes: float, tnom: float)#

This is a dataclass containing the properties of an AISC Circular section. Properties follow the AISC shapes database.

Parameters:

A (float) – Cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
C (float) – HSS torsional constant (in^3)
D_t (float) – Slenderness ratio for round HSS and pipe, D/t
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
J (float) – Torsional constant (in^4)
OD (float) – Outside diameter of round HSS or pipe (in)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
tdes (float) – Design thickness of HSS and pipe wall (in)
tnom (float) – Nominal thickness of HSS and pipe wall (in)

class efficalc.sections.AiscDoubleAngle(A: float, AISC_name: str, EDI_Std_Nomenclature: str, H: float, Ix: float, Iy: float, Sx: float, Sy: float, T_F: str, Type: str, W: float, Zx: float, Zy: float, b: float, b_t: float, d: float, ro: float, rx: float, ry: float, t: float, y: float, yp: float)#

This is a dataclass containing the properties of an AISC Double Angle section. Properties follow the AISC shapes database.

Parameters:

A (float) – Cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
H (float) – Flexural constant
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
b (float) – Width of the flat wall of the longer legs for back-to-back angles (in)
b_t (float) – Slenderness ratio for channel flange, b/t
d (float) – Overall depth of member, or width of shorter leg for angles (in)
ro (float) – Polar radius of gyration about the shear center (in)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (with no separation for double angles back-to-back) (in)
t (float) – Thickness of angle leg (in)
y (float) – Vertical distance from designated edge of member to center of gravity of member (in)
yp (float) – Vertical distance from designated edge of member to plastic neutral axis of member (in)

class efficalc.sections.AiscRectangular(A: float, AISC_name: str, Bout: float, C: float, EDI_Std_Nomenclature: str, Ht: float, Ix: float, Iy: float, J: float, Sx: float, Sy: float, T_F: str, Type: str, W: float, Zx: float, Zy: float, bin: float, b_tdes: float, h: float, h_tdes: float, rx: float, ry: float, tdes: float, tnom: float)#

This is a dataclass containing the properties of an AISC Rectangular section, typically representing rectangular HSS (Hollow Structural Section) properties. Properties follow the AISC shapes database.

Parameters:

A (float) – Cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
Bout (float) – Overall (outer) width of the rectangular HSS (in)
C (float) – HSS torsional constant (in^3)
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
Ht (float) – Overall (outer) depth of the longer wall of rectangular HSS (in)
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
J (float) – Torsional constant (in^4)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
bin (float) – Width of the shorter flat wall of rectangular HSS (in)
b_tdes (float) – Slenderness ratio for the shorter wall of rectangular HSS, b/tdes
h (float) – Depth of the longer flat wall of rectangular HSS (in)
h_tdes (float) – Slenderness ratio for the longer wall of rectangular HSS, h/tdes
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
tdes (float) – Design thickness of HSS wall (in)
tnom (float) – Nominal thickness of HSS wall (in)

class efficalc.sections.AiscTee(A: float, AISC_name: str, Cw: float, D_t: float, EDI_Std_Nomenclature: str, H: float, Ix: float, Iy: float, J: float, PA: float, PB: float, PC: float, PD: float, Sx: float, Sy: float, T_F: str, Type: str, W: float, WGi: float, Zx: float, Zy: float, bf: float, bfdet: float, bf_2tf: float, d: float, ddet: float, kdes: float, kdet: float, ro: float, rx: float, ry: float, tf: float, tfdet: float, tw: float, twdet: float, twdet_2: float, y: float, yp: float)#

This is a dataclass containing the properties of an AISC Tee section, typically derived from W-shapes, M-shapes, or S-shapes by cutting along the web. Properties follow the AISC shapes database.

Parameters:

A (float) – Cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
Cw (float) – Warping constant (in^6)
D_t (float) – Slenderness ratio for tee shapes, D/t where D=d
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
H (float) – Flexural constant
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
J (float) – Torsional constant (in^4)
PA (float) – Shape perimeter minus one flange surface, as used in Design Guide 19 (in)
PB (float) – Shape perimeter, as used in AISC Design Guide 19 (in)
PC (float) – Box perimeter minus one flange surface, as used in Design Guide 19 (in)
PD (float) – Box perimeter, as used in AISC Design Guide 19 (in)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
WGi (float) – The workable gage for the inner fastener holes in the flange (in)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
bf (float) – Width of flange (in)
bfdet (float) – Detailing value of flange width (in)
bf_2tf (float) – Slenderness ratio, bf/2tf
d (float) – Overall depth of member (in)
ddet (float) – Detailing value of member depth (in)
kdes (float) – Distance from outer face of flange to web toe of fillet used for design (in)
kdet (float) – Distance from outer face of flange to web toe of fillet used for detailing (in)
ro (float) – Polar radius of gyration about the shear center (in)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
tf (float) – Thickness of flange (in)
tfdet (float) – Detailing value of flange thickness (in)
tw (float) – Thickness of web (in)
twdet (float) – Detailing value of web thickness (in)
twdet_2 (float) – Half the web thickness for detailing purposes, twdet/2 (in)
y (float) – Vertical distance from designated edge of member to center of gravity of member (in)
yp (float) – Vertical distance from designated edge of member to plastic neutral axis of member (in)

class efficalc.sections.AiscWideFlange(A: float, AISC_name: str, Cw: float, EDI_Std_Nomenclature: str, Ix: float, Iy: float, J: float, PA: float, PB: float, PC: float, PD: float, Qf: float, Qw: float, Sw1: float, Sx: float, Sy: float, T: float, T_F: str, Type: str, W: float, WGi: float, Wno: float, Zx: float, Zy: float, bf: float, bfdet: float, bf_2tf: float, d: float, ddet: float, h_tw: float, ho: float, k1: float, kdes: float, kdet: float, rts: float, rx: float, ry: float, tf: float, tfdet: float, tw: float, twdet: float, twdet_2: float)#

This is a dataclass containing the properties of an AISC Wide Flange section. Properties follow the AISC shapes database.

Parameters:

A (float) – Cross-sectional area (in^2)
AISC_name (str) – The name of the AISC section
Cw (float) – Warping constant (in^6)
EDI_Std_Nomenclature (str) – The EDI standard nomenclature name
Ix (float) – Moment of inertia about the x-axis (in^4)
Iy (float) – Moment of inertia about the y-axis (in^4)
J (float) – Torsional constant (in^4)
PA (float) – Shape perimeter minus one flange surface, as used in Design Guide 19 (in)
PB (float) – Shape perimeter, as used in AISC Design Guide 19 (in)
PC (float) – Box perimeter minus one flange surface, as used in Design Guide 19 (in)
PD (float) – Box perimeter, as used in AISC Design Guide 19 (in)
Qf (float) – Statical moment for a point in the flange directly above the vertical edge of the web (in^3)
Qw (float) – Statical moment for a point at mid-depth of the cross section (in^3)
Sw1 (float) – Warping statical moment at point 1 on cross section (in^4)
Sx (float) – Elastic section modulus about the x-axis (in^3)
Sy (float) – Elastic section modulus about the y-axis (in^3)
T (float) – Distance between web toes of fillets at top and bottom of web (in)
T_F (str) – Whether the section has an additional note in the AISC shapes database (T or F)
Type (str) – The section type
W (float) – Nominal weight (lb/ft)
WGi (float) – The workable gage for the inner fastener holes in the flange (in)
Wno (float) – Normalized warping function, as used in Design Guide 9 (in^2)
Zx (float) – Plastic section modulus about the x-axis (in^3)
Zy (float) – Plastic section modulus about the y-axis (in^3)
bf (float) – Width of flange (in)
bfdet (float) – Detailing value of flange width (in)
bf_2tf (float) – Slenderness ratio for flange, bf/2tf
d (float) – Overall depth of member (in)
ddet (float) – Detailing value of member depth (in)
h_tw (float) – Slenderness ratio for web, h/tw
ho (float) – Distance between the flange centroids (in)
k1 (float) – Distance from web center line to flange toe of fillet used for detailing (in)
kdes (float) – Distance from outer face of flange to web toe of fillet used for design (in)
kdet (float) – Distance from outer face of flange to web toe of fillet used for detailing (in)
rts (float) – Effective radius of gyration (in)
rx (float) – Radius of gyration about the x-axis (in)
ry (float) – Radius of gyration about the y-axis (in)
tf (float) – Thickness of flange (in)
tfdet (float) – Detailing value of flange thickness (in)
tw (float) – Thickness of web (in)
twdet (float) – Detailing value of web thickness (in)
twdet_2 (float) – Half the web thickness for detailing purposes, twdet/2 (in)

efficalc.sections.get_aisc_angle(section_size: str) → AiscAngle#

Fetches the properties of a specified AISC Angle section from the sections database and returns an efficalc.sections.AiscAngle instance populated with these properties.

Parameters:: section_size (str) – The designation of the angle section size as the AISC_name property defined in the database.
Returns:: An Angle populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscAngle
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_channel(section_size: str) → AiscChannel#

Fetches the properties of a specified AISC Channel section from the sections database and returns a efficalc.sections.AiscChannel instance populated with these properties.

Parameters:: section_size (str) – The designation of the channel section size as the AISC_name property defined in the database.
Returns:: A Channel populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscChannel
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_circular(section_size: str) → AiscCircular#

Fetches the properties of a specified AISC Circular section from the sections database and returns a efficalc.sections.AiscCircular instance populated with these properties.

Parameters:: section_size (str) – The designation of the circular section size as the AISC_name property defined in the database.
Returns:: A Circular populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscCircular
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_double_angle(section_size: str) → AiscDoubleAngle#

Fetches the properties of a specified AISC Double Angle section from the sections database and returns a efficalc.sections.AiscDoubleAngle instance populated with these properties.

Parameters:: section_size (str) – The designation of the double angle section size as the AISC_name property defined in the database.
Returns:: A DoubleAngle populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscDoubleAngle
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_rectangular(section_size: str) → AiscRectangular#

Fetches the properties of a specified AISC Rectangular section from the sections database and returns a efficalc.sections.AiscRectangular instance populated with these properties.

Parameters:: section_size (str) – The designation of the rectangular section size as the AISC_name property defined in the database.
Returns:: A Rectangular populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscRectangular
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_tee(section_size: str) → AiscTee#

Fetches the properties of a specified AISC Tee section from the sections database and returns a efficalc.sections.AiscTee instance populated with these properties.

Parameters:: section_size (str) – The designation of the tee section size as the AISC_name property defined in the database.
Returns:: A Tee populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscTee
Raises:: ValueError – If the specified section size cannot be found in the sections database.

efficalc.sections.get_aisc_wide_flange(section_size: str) → AiscWideFlange#

Fetches the properties of a specified AISC Wide Flange section from the sections database and returns a efficalc.sections.AiscWideFlange instance populated with these properties.

Parameters:: section_size (str) – The designation of the wide flange section size as the AISC_name property defined in the database.
Returns:: A WideFlange populated with the properties of the specified section size.
Return type:: efficalc.sections.AiscWideFlange
Raises:: ValueError – If the specified section size cannot be found in the sections database.