Reinforcement steel materials¶

Reinforcement steel factory¶

structuralcodes.materials.reinforcement.create_reinforcement(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, name: str | None = None, density: float = 7850, design_code: str | None = None, **kwargs) → Reinforcement | None[source]¶

A factory function to create the correct type of reinforcement based on the desired design code.

Parameters:

fyk (float) – Characteristic yield strength in MPa.
Es (float) – The Young’s modulus in MPa.
ftk (float) – Characteristic ultimate strength in MPa.
epsuk (float) – The characteristik strain at the ultimate stress level.

Keyword Arguments:

gamma_s (Optional(float)) – The partial factor for reinforcement.
density (float) – Density of the material in kg/m3 (default: 7850)
design_code (str) – Optional string (default: None) indicating the desired standard. If None (default) the globally used design standard will be adopted. Otherwise the design standard specified will be used for the instance of the material.
**kwargs – Other valid keyword arguments that are collected and passed to the specific reinforcement material. Please inspect the documentation of the other reinforcement materials to see valid arguments.

Raises:

ValueError – If the design code is not valid or does not cover reinforcement as a material.

Eurocode 2 (2004)¶

class structuralcodes.materials.reinforcement.ReinforcementEC2_2004(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, gamma_eps: float | None = None, name: str | None = None, density: float = 7850.0, constitutive_law: Literal['elastic', 'elasticperfectlyplastic', 'elasticplastic'] | ConstitutiveLaw | None = 'elasticplastic', initial_strain: float | None = None, initial_stress: float | None = None, strain_compatibility: bool | None = None)[source]¶

Reinforcement implementation for EC2 2004.

__init__(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, gamma_eps: float | None = None, name: str | None = None, density: float = 7850.0, constitutive_law: Literal['elastic', 'elasticperfectlyplastic', 'elasticplastic'] | ConstitutiveLaw | None = 'elasticplastic', initial_strain: float | None = None, initial_stress: float | None = None, strain_compatibility: bool | None = None)[source]¶

Initializes a new instance of Reinforcement for EC2 2004.

Parameters:

fyk (float) – Characteristic yield strength in MPa.
Es (float) – The Young’s modulus in MPa.
ftk (float) – Characteristic ultimate strength in MPa.
epsuk (float) – The characteristik strain at the ultimate stress level.
gamma_s (Optional(float)) – The partial factor for reinforcement. Default value is 1.15.

Keyword Arguments:

gamma_eps (float) – The partial factor for ultimate strain. Default value is 0.9.
name (str) – A descriptive name for the reinforcement.
density (float) – Density of material in kg/m3 (default: 7850).
constitutive_law (ConstitutiveLaw | str) – A valid ConstitutiveLaw object for reinforcement or a string defining a valid constitutive law type for reinforcement. (valid options for string: ‘elastic’, ‘elasticplastic’, or ‘elasticperfectlyplastic’).
initial_strain (Optional[float]) – Initial strain of the material.
initial_stress (Optional[float]) – Initial stress of the material.
strain_compatibility (Optional[bool]) – Only relevant if initial_strain or initial_stress are different from zero. If True, the material deforms with the geometry. If False, the stress in the material upon loading is kept constant corresponding to the initial strain.

Raises:

ValueError – If the constitutive law name is not available for the material.
ValueError – If the provided constitutive law is not valid for reinforcement.

fyd() → float[source]¶: The design yield strength.

ftd() → float[source]¶: The design ultimate strength.

epsud() → float[source]¶: The design ultimate strain.

property fyk: float¶: Returns fyk in MPa.

property Es: float¶: Returns Es in MPa.

property ftk: float¶: Returns ftk in MPa.

property epsuk: float¶: Returns epsuk.

property epsyk: float¶: Returns characteristic yield strain epsyk.

property epsyd: float¶: Return the design yield strain.

property constitutive_law: ConstitutiveLaw¶: Returns the constitutive law object.

property gamma_s: float¶: The partial factor for reinforcement.

property gamma_eps: float¶: The partial factor for ultimate strain.

property name¶: Returns the name of the material.

property density¶: Returns the density of the material in kg/m3.

fib Model Code 2010¶

class structuralcodes.materials.reinforcement.ReinforcementMC2010(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, gamma_eps: float | None = None, name: str | None = None, density: float = 7850.0, constitutive_law: Literal['elastic', 'elasticperfectlyplastic', 'elasticplastic'] | ConstitutiveLaw | None = 'elasticplastic', initial_strain: float | None = None, initial_stress: float | None = None, strain_compatibility: bool | None = None)[source]¶

Reinforcement implementation for MC 2010.

Initializes a new instance of Reinforcement for MC2010.

Parameters:

fyk (float) – Characteristic yield strength in MPa.
Es (float) – The Young’s modulus in MPa.
ftk (float) – Characteristic ultimate strength in MPa.
epsuk (float) – The characteristik strain at the ultimate stress level.
gamma_s (Optional(float)) – The partial factor for reinforcement. Default value is 1.15.

Keyword Arguments:

gamma_eps (float) – The partial factor for ultimate strain. Default value is 0.9.
name (str) – A descriptive name for the reinforcement.
density (float) – Density of material in kg/m3 (default: 7850).
constitutive_law (ConstitutiveLaw | str) – A valid ConstitutiveLaw object for reinforcement or a string defining a valid constitutive law type for reinforcement. (valid options for string: ‘elastic’, ‘elasticplastic’, or ‘elasticperfectlyplastic’).
initial_strain (Optional[float]) – Initial strain of the material.
initial_stress (Optional[float]) – Initial stress of the material.
strain_compatibility (Optional[bool]) – Only relevant if initial_strain or initial_stress are different from zero. If True, the material deforms with the geometry. If False, the stress in the material upon loading is kept constant corresponding to the initial strain.

Raises:

ValueError – If the constitutive law name is not available for the material.
ValueError – If the provided constitutive law is not valid for reinforcement.

fyd() → float[source]¶: The design yield strength.

ftd() → float[source]¶: The design ultimate strength.

epsud() → float[source]¶: The design ultimate strain.

property fyk: float¶: Returns fyk in MPa.

property Es: float¶: Returns Es in MPa.

property ftk: float¶: Returns ftk in MPa.

property epsuk: float¶: Returns epsuk.

property epsyk: float¶: Returns characteristic yield strain epsyk.

property epsyd: float¶: Return the design yield strain.

property constitutive_law: ConstitutiveLaw¶: Returns the constitutive law object.

property gamma_s: float¶: The partial factor for reinforcement.

property gamma_eps: float¶: The partial factor for ultimate strain.

property name¶: Returns the name of the material.

property density¶: Returns the density of the material in kg/m3.

Eurocode 2 (2023)¶

class structuralcodes.materials.reinforcement.ReinforcementEC2_2023(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, name: str | None = None, density: float = 7850.0, constitutive_law: Literal['elastic', 'elasticperfectlyplastic', 'elasticplastic'] | ConstitutiveLaw | None = 'elasticplastic', initial_strain: float | None = None, initial_stress: float | None = None, strain_compatibility: bool | None = None)[source]¶

Reinforcement implementation for EC2 2023.

__init__(fyk: float, Es: float, ftk: float, epsuk: float, gamma_s: float | None = None, name: str | None = None, density: float = 7850.0, constitutive_law: Literal['elastic', 'elasticperfectlyplastic', 'elasticplastic'] | ConstitutiveLaw | None = 'elasticplastic', initial_strain: float | None = None, initial_stress: float | None = None, strain_compatibility: bool | None = None)[source]¶

Initializes a new instance of Reinforcement for EC2 2023.

Parameters:

fyk (float) – Characteristic yield strength in MPa.
Es (float) – The Young’s modulus in MPa.
ftk (float) – Characteristic ultimate strength in MPa.
epsuk (float) – The characteristik strain at the ultimate stress level.
gamma_s (Optional(float)) – The partial factor for reinforcement. Default value is 1.15.

Keyword Arguments:

name (str) – A descriptive name for the reinforcement.
density (float) – Density of material in kg/m3 (default: 7850).
constitutive_law (ConstitutiveLaw | str) – A valid ConstitutiveLaw object for reinforcement or a string defining a valid constitutive law type for reinforcement. (valid options for string: ‘elastic’, ‘elasticplastic’, or ‘elasticperfectlyplastic’).
initial_strain (Optional[float]) – Initial strain of the material.
initial_stress (Optional[float]) – Initial stress of the material.
strain_compatibility (Optional[bool]) – Only relevant if initial_strain or initial_stress are different from zero. If True, the material deforms with the geometry. If False, the stress in the material upon loading is kept constant corresponding to the initial strain.

Raises:

ValueError – If the constitutive law name is not available for the material.
ValueError – If the provided constitutive law is not valid for reinforcement.

fyd() → float[source]¶: The design yield strength.

ftd() → float[source]¶: The design ultimate strength.

epsud() → float[source]¶: The design ultimate strain.

property fyk: float¶: Returns fyk in MPa.

property Es: float¶: Returns Es in MPa.

property ftk: float¶: Returns ftk in MPa.

property epsuk: float¶: Returns epsuk.

property epsyk: float¶: Returns characteristic yield strain epsyk.

property epsyd: float¶: Return the design yield strain.

property constitutive_law: ConstitutiveLaw¶: Returns the constitutive law object.

property gamma_s: float¶: The partial factor for reinforcement.

property name¶: Returns the name of the material.

property density¶: Returns the density of the material in kg/m3.