Clay¶

class toms_structures.unreinforced_masonry.Clay(length: float, height: float, thickness: float, fuc: float, mortar_class: int, bedding_type: bool = None, verbose: bool = True, hu: float = None, tj: float = None, face_shell_thickness: float = None, raking: float = None, fmt: float = None, grouted: float = None, fcg: float = None)¶

Bases: _Masonry

Clay Masonry object

Parameters:

length (float) – length of the wall in mm
height (float) – height of the wall in mm
thickness (float) – thickness of the wall in mm
fuc (float) – unconfined compressive capacity in MPa, typically 20 MPa in new structures and 10-12 MPa for existing structures
mortar_class (float) – Mortar class in accordance with AS3700
bedding_type (bool) – True if fully grout bedding, False if face shell bedding
verbose (float) – True to print internal calculations False otherwise
hu (float) – masonry unit height in mm, defaults to 76 mm
tj (float) – grout thickness between masonry units in mm, defaults to 10 mm
raking (float) – depth of raking in mm, defaults to 0 mm
fmt (float) – Characteristic flexural tensile strength of masonry in MPa, defaults to 0.2 MPa

Methods

`basic_compressive_capacity`	Computes the Basic Compressive strength to AS3700 Cl 7.3.2(2) and returns the compressive capacity in KN.
`compression_capacity`	Computes the compression capacity of a masonry wall using the simplified method in AS3700.
`concentrated_load`	Computes the simplified compression capacity of a masonry wall under concentrated loads
`horizontal_bending`	Computes the horizontal bending capacity in accordance with AS3700 Cl 7.4.3.2
`horizontal_plane_shear`	Calculates the horizontal shear capacity in accordance with AS3700:2018 Cl 7.5.4.1
`refined_compression`	Computes the refined compressive capacity of a masonry wall per AS3700 Cl 7.3.
`refined_concentrated_load`	Computes the refined compressive capacity of a masonry wall per AS3700 Cl 7.3.
`vertical_bending`	Computes the vertical bending capacity in accordance with AS 3700 Cl 7.4.2
`vertical_plane_shear`	Computes the horizontal shear capacity in accordance with AS3700 Cl 7.5.4.2

Attributes

`density`
`face_shell_thickness`
`fcg`
`fmt`
`fut`
`grouted`
`hu`
`phi_bending`
`phi_compression`
`phi_shear`
`raking`
`tj`

basic_compressive_capacity(verbose: bool = True) → float¶

Computes the Basic Compressive strength to AS3700 Cl 7.3.2(2) and returns the compressive capacity in KN. This does not account for wall geometry, including whether it is face-shell bedding.

Parameters:: verbose (bool) – True to print calculations
Return type:: basic compressive capacity in KN

compression_capacity(simple_av: float | None = None, kt: float | None = None, compression_load_type: int | None = None, verbose: bool = True) → float¶

Computes the compression capacity of a masonry wall using the simplified method in AS3700.

Parameters:

simple_av (float) –
Vertical slenderness coefficient

1 if the member is laterally supported along its top edge

2.5 if the member is not laterally supported along its top edge
kt (float) –
a thickness coefficient derived from Table 7.2

1 - if there are no engaged piers

If the engagement of a pier to the wall does not meet the requirements of

Clause 4.11 for bonding or tying, the value of kt shall be taken as 1.0.
compression_load_type (int) –
Type of compression loading:

1 - concrete slab

2 - other systems (see Table 7.1)

3 - wall with load applied to the face (see Table 7.1)
verbose (bool) – If True, print internal calculation details.

Return type:

A dictionary with crushing and buckling capacity in kN.

Computes the simplified compression capacity of a masonry wall under concentrated loads

Parameters:

simple_av (float) –
Vertical slenderness coefficient

1 if the member is laterally supported along its top edge

2.5 if the member is not laterally supported along its top edge
kt (float) –
a thickness coefficient derived from Table 7.2

1 - if there are no engaged piers

If the engagement of a pier to the wall does not meet the requirements of

Clause 4.11 for bonding or tying, the value of kt shall be taken as 1.0.
compression_load_type (int) –
Type of compression loading:

1 - concrete slab

2 - other systems (see Table 7.1)

3 - wall with load applied to the face (see Table 7.1)
dist_to_end (float) – Defined as the shortest distance from the edge of the bearing area to the edge of the wall, refer AS3700 Cl 7.3.5.4.
bearing_width (float) – Width of the bearing area in mm.
bearing_length (float) – Length of the bearing area in mm.
verbose (bool) – If True, print internal calculation details.

Return type:

A dictionary with crushing and buckling capacity in kN.

horizontal_bending(fd: float | None = None, interface: None | bool = None, verbose: bool = True) → float¶

Computes the horizontal bending capacity in accordance with AS3700 Cl 7.4.3.2

Parameters:

fd (float) – The minimum design compressive stress on the bed joint at the cross-section under consideration (see Clause 7.4.3.3), in MPa
interface (bool) – True if shear plane is masonry to masonry, and False if shear_plane is masonry to other material
verbose (bool) – Whether to print outputs

Returns:

Horizontal bending capacity in KN

Return type:

float

horizontal_plane_shear(kv: float, interface: float, fd: float, verbose: bool = True) → dict¶

Calculates the horizontal shear capacity in accordance with AS3700:2018 Cl 7.5.4.1

Parameters:

kv (float) –
shear factor (see AS3700 T3.3). At mortar bed joints or interfaces with concrete = 0.3

At interfaces with steel = 0.2

At slip joints comprising two layers of membrane-type DPC material = 0.1

For other locations see AS3700 T3.3 or assume 0.
interface (bool) – True if shear plane is masonry to masonry, and False if shear_plane is masonry to other material
fd (float) – the minimum design compressive stress on the bed joint at the cross-section under consideration (see Clause 7.4.3.3), in MPa
verbose (bool) – Whether to print outputs

Returns:

Horizontal shear capacity in KN

Return type:

float

refined_compression(refined_av: float, refined_ah: float, kt: float, e1: float, e2: float, dist_to_return: float | None = None, effective_length: float | None = None, verbose: bool = True) → dict¶

Computes the refined compressive capacity of a masonry wall per AS3700 Cl 7.3.

Parameters:

refined_av (float) –
Vertical slenderness coefficient

0.75 for a wall laterally supported and partially rotationally restrained at both top and bottom

0.85 for a wall laterally supported at top and bottom and partially rotationally restrained at one end

1.0 for a wall laterally supported at both top and bottom

1.5 for a wall laterally supported and partially rotationally restrained at the bottom and partially laterally supported at the top

2.5 for freestanding walls

refer AS 3700 Cl 7.3.4.3.
refined_ah (float) –
Horizontal slenderness coefficient

0 - for a wall with no lateral supports

1 - for a wall laterally supported along both vertical edges (regardless of the rotational restraint along these edges)

2.5 - for a wall laterally supported along one vertical edge, and unsupported along its other vertical edge

Refer Figure 7.2 AS3700

ktfloat
A thickness coefficient derived from Table 7.2

1 - if there are no engaged piers

If the engagement of a pier to the wall does not meet the requirements of

Clause 4.11 for bonding or tying, the value of kt shall be taken as 1.0.

e1float: The larger eccentricity of the vertical force, at either top or bottom of the member in mm
e2float: The smaller eccentricity of the vertical force, at the other end of the member, not less than el, and negative when the eccentricities are on opposite sides of the member, given in mm
dist_to_returnfloat: Distance to return wall in mm. Note, this may be different from the length of the wall. For example, if only looking at a section of the wall, or a section which extends beyond.
effective_lengthfloat: Length of wall used in calculations in mm
verbosebool: Whether to print outputs.

Returns:

dict ({) – ‘Crushing’: crushing_compressive_capacity, ‘Buckling’: kFo,
}

Computes the refined compressive capacity of a masonry wall per AS3700 Cl 7.3.

Parameters:

refined_av (float) –
Vertical slenderness coefficient

0.75 for a wall laterally supported and partially rotationally restrained at both top and bottom

0.85 for a wall laterally supported at top and bottom and partially rotationally restrained at one end

1.0 for a wall laterally supported at both top and bottom

1.5 for a wall laterally supported and partially rotationally restrained at the bottom and partially laterally supported at the top

2.5 for freestanding walls

refer AS 3700 Cl 7.3.4.3.
refined_ah (float) –
Horizontal slenderness coefficient

1 - for a wall laterally supported along both vertical edges (regardless of the rotational restraint along these edges)

2.5 - for a wall laterally supported along one vertical edge, and unsupported along its other vertical edge

Refer Figure 7.2 AS3700

ktfloat
A thickness coefficient derived from Table 7.2

1 - if there are no engaged piers

If the engagement of a pier to the wall does not meet the requirements of

Clause 4.11 for bonding or tying, the value of kt shall be taken as 1.0.

e1float: The larger eccentricity of the vertical force, at either top or bottom of the member
e2float: The smaller eccentricity of the vertical force, at the other end of the member, not less than el, and negative when the eccentricities are on opposite sides of the member
dist_to_returnfloat: Distance to return wall (mm).
effective_lengthfloat: Length of wall used in calculations (mm).
dist_to_endfloat: Defined as the shortest distance from the edge of the bearing area to the edge of the wall, refer AS3700 Cl 7.3.5.4.
bearing_widthfloat: Width of the bearing area in mm.
bearing _lengthfloat: Length of the bearing area in mm.
verbosebool: If True, print internal calculation details.

Returns:

dict ({) – “Crushing”, “Buckling”, “Bearing”
}

vertical_bending(fd: float | None = None, interface: None | bool = None, verbose: bool = True) → float¶

Computes the vertical bending capacity in accordance with AS 3700 Cl 7.4.2

Parameters:

fd (float) – The minimum design compressive stress on the bed joint at the cross-section under consideration (see Clause 7.4.3.3), in MPa
interface (bool) – True if shear plane is masonry to masonry, and False if shear_plane is masonry to other material
verbose (bool) – Whether to print outputs

Returns:

m_cv

Return type:

float

vertical_plane_shear(verbose: bool = True) → float¶: Computes the horizontal shear capacity in accordance with AS3700 Cl 7.5.4.2