Concrete materials

Concrete factory

structuralcodes.materials.concrete.create_concrete(fck: float, name: str | None = None, density: float = 2400.0, gamma_c: float | None = None, existing: bool = False, design_code: str | None = None, **kwargs) → Concrete | None

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

Parameters:

fck (float) – Characteristic strength of concrete in MPa. (if existing it is intended as the mean strength).

Keyword Arguments:

• density (float) – Density of Concrete in kg/m3 (default: 2400).

• gamma_c (Optional(float)) – The partial factor for concrete.

• existing (bool) – Boolean indicating if the concrete is of an existing structure (default: False).

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

Raises:

ValueError – if the design code is not valid or does not cover concrete as a material.

Eurocode 2 (2004)

class structuralcodes.materials.concrete.ConcreteEC2_2004(fck: float, name: str | None = None, density: float = 2400, gamma_c: float | None = None, alpha_cc: float | None = None, **kwargs)

Concrete implementation for EC2 2004.

__init__(fck: float, name: str | None = None, density: float = 2400, gamma_c: float | None = None, alpha_cc: float | None = None, **kwargs) → None

Initializes a new instance of Concrete for EC2 2004.

Parameters:

fck (float) – Characteristic strength in MPa if concrete is not existing.

Keyword Arguments:

• name (str) – A descriptive name for concrete.

• density (float) – Density of material in kg/m3 (default: 2400).

• gamma_c (float, optional) – partial factor of concrete (default is 1.5).

• alpha_cc (float, optional) – A factor for considering long-term effects on the strength, and effects that arise from the way the load is applied.

fcd() → float

Return the design compressive strength in MPa.

Returns:

The design compressive strength of concrete in MPa.

Return type:

float

property fcm: float

Returns fcm in MPa.

Returns:

The mean compressive strength in MPa.

Return type:

float

property fctm: float

Returns fctm in MPa.

Returns:

The mean tensile strength in MPa.

Return type:

float

property fctk_5: float

Returns fctk_5 in MPa.

Returns:

The lower bound tensile strength in MPa.

Return type:

float

property fctk_95: float

Returns fctk_95 in MPa.

Returns:

The upper bound tensile strength in MPa.

Return type:

float

property Ecm: float

Returns Ecm in MPa.

Returns:

The upper bound tensile strength in MPa.

Return type:

float

property gamma_c: float

The partial factor for concrete.

property alpha_cc: float

The alpha_cc factor.

property eps_c1: float

Returns the strain at maximum compressive strength of concrete (fcm) for the Sargin constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu1: float

Returns the strain at concrete failure of concrete.

Returns:

The maximum strength at failure of concrete.

Return type:

float

property k_sargin: float

Returns the coefficient for Sargin constitutive law.

Returns:

The plastic coefficient for Sargin law.

Return type:

float

property eps_c2: float

Returns the strain at maximum compressive strength of concrete (fcd) for the Parabola-rectangle constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu2: float

Returns the strain at concrete failure of concrete for the Parabola-rectangle constitutive law.

Returns:

The maximum strain at failure of concrete.

Return type:

float

property n_parabolic_rectangular: float

Returns the coefficient for Parabola-rectangle constitutive law.

Returns:

The exponent for Parabola-rectangle law.

Return type:

float

property eps_c3: float

Returns the strain at maximum compressive strength of concrete (fcd) for the Bi-linear constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu3: float

Returns the strain at concrete failure of concrete for the Bi-linear constitutive law.

Returns:

The maximum strain at failure of concrete.

Return type:

float

fib Model Code 2010

class structuralcodes.materials.concrete.ConcreteMC2010(fck: float, name: str | None = None, density: float = 2400.0, gamma_c: float | None = None, existing: bool = False, alpha_cc: float | None = None, **kwargs)

Concrete implementation for MC 2010.

__init__(fck: float, name: str | None = None, density: float = 2400.0, gamma_c: float | None = None, existing: bool = False, alpha_cc: float | None = None, **kwargs)

Initializes a new instance of Concrete for MC 2010.

Parameters:

fck (float) – Characteristic strength in MPa if concrete is not existing.

Keyword Arguments:

• name (Optional(str)) – A descriptive name for concrete.

• density (float) – Density of material in kg/m3 (default: 2400).

• gamma_c (Optional(float)) – The partial factor for concrete.

• existing (bool) – The material is of an existing structure (default: False).

• alpha_cc (float, optional) – A factor for considering long-term effects on the strength, and effects that arise from the way the load is applied.

fcd() → float

Return the design compressive strength in MPa.

Returns:

The design compressive strength of concrete in MPa.

Return type:

float

property fcm: float

Returns fcm in MPa.

Returns:

The mean compressive strength in MPa.

Return type:

float

property Eci: float

Returns the modulus of elasticity in MPa at the concrete age of 28 days.

It is assumed a normal concrete with quartzite aggregates (alfa_e = 1)

property fctm: float

Returns fctm in MPa.

Returns:

The mean tensile strength in MPa.

Return type:

float

property fctkmin: float

Returns fctkmin in MPa.

Returns:

The lower bound tensile strength in MPa.

Return type:

float

property fctkmax: float

Returns fctkmax in MPa.

Returns:

The upper bound tensile strength in MPa.

Return type:

float

property Gf: float

Fracture energy of concrete.

Returns:

The fracture energy in N/m.

Return type:

float

property gamma_c: float

The partial factor for concrete.

property alpha_cc: float

The alpha_cc factor.

property eps_c1: float

Returns the strain at maximum compressive strength of concrete (fcm) for the Sargin constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu1: float

Returns the strain at concrete failure of concrete.

Returns:

The maximum strength at failure of concrete.

Return type:

float

property k_sargin: float

Returns the coefficient for Sargin constitutive law.

Returns:

The plastic coefficient for Sargin law.

Return type:

float

property eps_c2: float

Returns the strain at maximum compressive strength of concrete (fcd) for the Parabola-rectangle constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu2: float

Returns the strain at concrete failure of concrete for the Parabola-rectangle constitutive law.

Returns:

The maximum strain at failure of concrete.

Return type:

float

property n_parabolic_rectangular: float

Returns the coefficient for Parabola-rectangle constitutive law.

Returns:

The exponent for Parabola-recangle law.

Return type:

float

property eps_c3: float

Returns the strain at maximum compressive strength of concrete (fcd) for the Bi-linear constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu3: float

Returns the strain at concrete failure of concrete for the Bi-linear constitutive law.

Returns:

The maximum strain at failure of concrete.

Return type:

float

Eurocode 2 (2023)

class structuralcodes.materials.concrete.ConcreteEC2_2023(fck: float, name: str | None = None, density: float = 2400.0, kE: float = 9500, strength_dev_class: Literal['CS', 'CN', 'CR', 'slow', 'normal', 'rapid'] = 'CN', gamma_c: float | None = None, existing: bool = False, **kwargs)

Concrete implementation for EC2 2023 Concrete.

__init__(fck: float, name: str | None = None, density: float = 2400.0, kE: float = 9500, strength_dev_class: Literal['CS', 'CN', 'CR', 'slow', 'normal', 'rapid'] = 'CN', gamma_c: float | None = None, existing: bool = False, **kwargs)

Initializes a new instance of Concrete for EC2 2023.

Parameters:

fck (float) – Characteristic strength in MPa if concrete is not existing.

Keyword Arguments:

• name (str) – A descriptive name for concrete.

• density (float) – Density of material in kg/m3 (default: 2400).

• kE (float) – Coefficient relating aggregates.

• strength_dev_class (str, optional) – Default is CN. Possible values: CS, CN, CR, slow, normal or rapid.

• gamma_c (float, optional) – Partial factor of concrete (default is 1.5).

• existing (bool, optional) – The material is of an existing structure (default: False).

fcd(t_ref: float = 28, t0: float = 91, fck_ref: float = 40) → float

Computes the value of the design compressive strength of concrete.

Parameters:

• t_ref (float,optional) – The reference time in days (default is 28 days).

• t0 (float, optional) – Age at loading in days (default is 91 days).

• fck_ref (float, optional) – The reference compressive strength in MPa (default is 40 MPa).

Returns:

The design compressive strength of concrete in MPa.

Return type:

float

Raises:

• ValueError – If fck_ref is less or equal to 0.

• ValueError – If t_ref is less than 0.

• ValueError – If t0 is less than 0.

fctd(t_ref: float = 28) → float

Computes the value of the design tensile strength of concrete.

Parameters:

t_ref (float, optional) – The reference time in days (default is 28 days).

Returns:

The design tensile strength of concrete in MPa.

Return type:

float

Raises:

ValueError – If t_ref is less than 0.

property fcm: float

Returns the mean strength of concrete.

Returns:

The mean compressive strength in MPa.

Return type:

float

property fctm: None

Returns the mean concrete tensile strength.

Returns:

The mean concrete tensile strength.

Return type:

float

property fctk_5: float

Returns the 5% mean concrete tensile strength fractile.

Returns:

The 5% mean concrete tensile strength fractile in MPa.

Return type:

float

property fctk_95: float

Returns the 95% mean concrete tensile strength fractile.

Returns:

The 5% mean concrete tensile strength fractile in MPa.

Return type:

float

property Ecm: float

Returns the secant modulus.

Returns:

The secant concrete modulus in MPa.

Return type:

float

property gamma_c: float

The partial factor for concrete.

property eps_c1: float

Returns the strain at maximum compressive strength of concrete (fcm) for the Sargin constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu1: float

Returns the strain at concrete failure of concrete.

Returns:

The maximum strength at failure of concrete.

Return type:

float

property k_sargin: float

Returns the k coefficient for Sargin constitutive law.

Returns:

k coefficient for Sargin constitutive law.

Return type:

float

property eps_c2: float

Returns the strain at maximum compressive strength of concrete (fcd) for the Parabola-rectangle constitutive law.

Returns:

The strain at maximum compressive strength of concrete.

Return type:

float

property eps_cu2: float

Returns the strain at concrete failure of concrete for the Parabola-rectangle constitutive law.

Returns:

The maximum strain at failure of concrete.

Return type:

float

property n_parabolic_rectangular: float

Returns the coefficient for Parabola-rectangle constitutive law.

Returns:

The exponent for Parabola-recangle law.

Return type:

float