structuralcodes 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

structuralcodes/materials/constitutive_laws/_parabolarectangle.py

@@ -0,0 +1,198 @@
+"""Parabola-Rectangle constitutive law."""
+
+from __future__ import annotations  # To have clean hints of ArrayLike in docs
+
+import typing as t
+
+import numpy as np
+from numpy.typing import ArrayLike
+
+from ...core.base import ConstitutiveLaw
+
+
+class ParabolaRectangle(ConstitutiveLaw):
+    """Class for parabola rectangle constitutive law.
+
+    The stresses and strains are assumed negative in compression and positive
+    in tension.
+    """
+
+    __materials__: t.Tuple[str] = ('concrete',)
+
+    def __init__(
+        self,
+        fc: float,
+        eps_0: float = -0.002,
+        eps_u: float = -0.0035,
+        n: float = 2.0,
+        name: t.Optional[str] = None,
+    ) -> None:
+        """Initialize a Parabola-Rectangle Material.
+
+        Arguments:
+            fc (float): The strength of concrete in compression.
+
+        Keyword Arguments:
+            eps_0 (float): Peak strain of concrete in compression. Default
+                value = -0.002.
+            eps_u (float): Ultimate strain of concrete in compression. Default
+                value = -0.0035.
+            n (float): Exponent for the pre-peak branch. Default value = 2.
+            name (str): A name for the constitutive law.
+        """
+        name = name if name is not None else 'ParabolaRectangleLaw'
+        super().__init__(name=name)
+        self._fc = -abs(fc)
+        self._eps_0 = -abs(eps_0)
+        self._eps_u = -abs(eps_u)
+        self._n = n
+
+    def get_stress(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the stress given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # Preprocess eps array in order
+        eps = self.preprocess_strains_with_limits(eps=eps)
+        # Compute stress
+        # If it is a scalar
+        if np.isscalar(eps):
+            sig = 0
+            if self._eps_0 <= eps <= 0:
+                sig = self._fc * (1 - (1 - eps / self._eps_0) ** self._n)
+            if self._eps_u <= eps < self._eps_0:
+                sig = self._fc
+            return sig
+        # If it is an array
+        sig = np.zeros_like(eps)
+        # Parabolic branch
+        sig[(eps <= 0) & (eps >= self._eps_0)] = self._fc * (
+            1
+            - (1 - (eps[(eps <= 0) & (eps >= self._eps_0)] / self._eps_0))
+            ** self._n
+        )
+        # Rectangle branch
+        sig[eps < self._eps_0] = self._fc
+        # Zero elsewhere
+        sig[eps < self._eps_u] = 0
+        sig[eps > 0] = 0
+        return sig
+
+    def get_tangent(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the tangent given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # If it is a scalar
+        if np.isscalar(eps):
+            tangent = 0
+            if self._eps_0 <= eps <= 0:
+                tangent = (
+                    self._n
+                    * self._fc
+                    / self._eps_0
+                    * (1 - (eps / self._eps_0)) ** (self._n - 1)
+                )
+            return tangent
+        # If it is an array
+        # parabolic branch
+        tangent = np.zeros_like(eps)
+        tangent[(eps <= 0) & (eps >= self._eps_0)] = (
+            self._n
+            * self._fc
+            / self._eps_0
+            * (1 - (eps[(eps <= 0) & (eps >= self._eps_0)] / self._eps_0))
+            ** (self._n - 1)
+        )
+        # Elsewhere tangent is zero
+        tangent[eps < self._eps_0] = 0.0
+        tangent[eps > 0] = 0.0
+        return tangent
+
+    def __marin__(
+        self, strain: t.Tuple[float, float]
+    ) -> t.Tuple[t.List[float], t.List[float]]:
+        """Returns coefficients and strain limits for Marin integration in a
+        simply formatted way.
+
+        Arguments:
+            strain (float, float): Tuple defining the strain profile: eps =
+                strain[0] + strain[1]*y.
+
+        Example:
+            [(0, -0.002), (-0.002, -0.003)]
+            [(a0, a1, a2), (a0)]
+        """
+        if self._n != 2:
+            # The constitutive law is not writtable as a polynomial,
+            # Call the generic distretizing method
+            return super().__marin__(strain=strain)
+
+        strains = []
+        coeff = []
+        if strain[1] == 0:
+            # Uniform strain equal to strain[0]
+            # understand in which branch are we
+            strain[0] = self.preprocess_strains_with_limits(strain[0])
+            if strain[0] > 0:
+                # We are in tensile branch
+                strains = None
+                coeff.append((0.0,))
+            elif strain[0] > self._eps_0:
+                # We are in the parabolic branch
+                strains = None
+                a0 = (
+                    2
+                    * self._fc
+                    * strain[0]
+                    / self._eps_0
+                    * (1 - 0.5 * (strain[0] / self._eps_0))
+                )
+                a1 = (
+                    2
+                    * self._fc
+                    / self._eps_0
+                    * strain[1]
+                    * (1 - strain[0] / self._eps_0)
+                )
+                coeff.append((a0, a1, 0.0))
+            elif strain[0] >= self._eps_u:
+                # We are in the constant branch
+                strains = None
+                coeff.append((self._fc,))
+            else:
+                # We are in a branch of non-resisting concrete
+                # Too much compression
+                strains = None
+                coeff.append((0.0,))
+        else:
+            # Parabolic part
+            strains.append((self._eps_0, 0))
+            a0 = (
+                2
+                * self._fc
+                * strain[0]
+                / self._eps_0
+                * (1 - 0.5 * (strain[0] / self._eps_0))
+            )
+            a1 = (
+                2
+                * self._fc
+                / self._eps_0
+                * strain[1]
+                * (1 - strain[0] / self._eps_0)
+            )
+            a2 = -self._fc * strain[1] ** 2 / self._eps_0**2
+            coeff.append((a0, a1, a2))
+            # Constant part
+            strains.append((self._eps_u, self._eps_0))
+            coeff.append((self._fc,))
+        return strains, coeff
+
+    def get_ultimate_strain(
+        self, yielding: bool = False
+    ) -> t.Tuple[float, float]:
+        """Return the ultimate strain (negative and positive)."""
+        if yielding:
+            return (self._eps_0, 100)
+        return (self._eps_u, 100)

structuralcodes/materials/constitutive_laws/_popovics.py

@@ -0,0 +1,133 @@
+"""Popovics constitutive law."""
+
+from __future__ import annotations  # To have clean hints of ArrayLike in docs
+
+import typing as t
+
+import numpy as np
+from numpy.typing import ArrayLike
+
+from ...core.base import ConstitutiveLaw
+
+
+class Popovics(ConstitutiveLaw):
+    """Class for Popovics-Mander constitutive law.
+
+    The stresses and strains are assumed negative in compression and positive
+    in tension.
+
+    If the relation Ec = 5000 * sqrt(fc) is used for elastic modulus, the
+    constitutive law is identical to the one proposed by Mander et al. (1988).
+
+    References:
+    Popovics, S., 1973, “A Numerical Approach to the Complete Stress-Strain
+    Curve of Concrete”, Cement and Concrete Research, 3(4), 583-599.
+
+    Mander, J.B., Priestley, M.J.N., Park, R., 1988, "Theoretical Stress-Strain
+    Model for Confined Concrete", Journal of Structural Engineering, 114(8),
+    1804-1826.
+    """
+
+    __materials__: t.Tuple[str] = ('concrete',)
+
+    def __init__(
+        self,
+        fc: float,
+        eps_c: float = -0.002,
+        eps_cu: float = -0.0035,
+        Ec: t.Optional[float] = None,
+        name: t.Optional[str] = None,
+    ) -> None:
+        """Initialize a Popovics Material.
+
+        Arguments:
+            fc (float): the strength of concrete in compression
+
+        Keyword Arguments:
+            eps_c (float): Peak strain of concrete in compression. Default
+                value = -0.002.
+            eps_cu (float): Ultimate strain of concrete in compression. Default
+                value = -0.0035.
+            E (optional float): Elastic modulus of concrete. If None, the
+                equation Ec = 5000 * fc**0.5 proposed by Mander et al. (1988)
+                is adopted (fc in MPa). Default value = None.
+            name (str): A name for the constitutive law.
+
+        Raises:
+            ValueError: If E is less or equal to 0.
+
+        Note:
+            If positive values are input for fc, eps_c and eps_cu are input,
+            they will be assumed negative.
+        """
+        name = name if name is not None else 'PopovicsLaw'
+        super().__init__(name=name)
+        self._fc = -abs(fc)
+        self._eps_c = -abs(eps_c)
+        self._eps_cu = -abs(eps_cu)
+        if Ec is None:
+            # fc in MPa, relation of Mander et al. (1988)
+            Ec = 5000 * abs(fc) ** 0.5
+        if Ec <= 0:
+            raise ValueError('Elastic modulus must be a positive number.')
+        E_sec = self._fc / self._eps_c
+        self._n = Ec / (Ec - E_sec)
+
+    def get_stress(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the stress given the strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # Preprocess eps array in order
+        eps = self.preprocess_strains_with_limits(eps=eps)
+        # Compute stress
+        # Compression branch
+        eta = eps / self._eps_c
+
+        sig = self._fc * eta * self._n / (self._n - 1 + eta**self._n)
+
+        # Elsewhere stress is 0.0
+        if np.isscalar(eps):
+            if eps < self._eps_cu or eps > 0:
+                return 0.0
+        else:
+            sig[eps < self._eps_cu] = 0.0
+            sig[eps > 0] = 0.0
+
+        return sig
+
+    def get_tangent(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the tangent given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # Preprocess eps array in order
+        eps = self.preprocess_strains_with_limits(eps=eps)
+        # Compression branch
+        eta = eps / self._eps_c
+
+        tangent = (
+            (1 - eta**self._n)
+            / (self._n - 1 + eta**self._n) ** 2
+            * self._n
+            * (self._n - 1)
+            * self._fc
+            / self._eps_c
+        )
+        # Elsewhere tangent is zero
+        if np.isscalar(eps):
+            if eps < self._eps_cu or eps > 0:
+                return 0
+        else:
+            tangent[eps < self._eps_cu] = 0.0
+            tangent[eps > 0] = 0.0
+
+        return tangent
+
+    def get_ultimate_strain(
+        self, yielding: bool = False
+    ) -> t.Tuple[float, float]:
+        """Return the ultimate strain (negative and positive)."""
+        if yielding:
+            return (self._eps_c, 100)
+        return (self._eps_cu, 100)

structuralcodes/materials/constitutive_laws/_sargin.py

@@ -0,0 +1,115 @@
+"""Sargin constitutive law."""
+
+from __future__ import annotations  # To have clean hints of ArrayLike in docs
+
+import typing as t
+
+import numpy as np
+from numpy.typing import ArrayLike
+
+from ...core.base import ConstitutiveLaw
+
+
+class Sargin(ConstitutiveLaw):
+    """Class for Sargin constitutive law.
+
+    The stresses and strains are assumed negative in compression and positive
+    in tension.
+
+    References:
+    Sargin, M. (1971), "Stress-strain relationship for concrete and the
+    analysis of structural concrete section, Study No. 4,
+    Solid Mechanics Division, University of Waterloo, Ontario, Canada
+    """
+
+    __materials__: t.Tuple[str] = ('concrete',)
+
+    def __init__(
+        self,
+        fc: float,
+        eps_c1: float = -0.0023,
+        eps_cu1: float = -0.0035,
+        k: float = 2.04,
+        name: t.Optional[str] = None,
+    ) -> None:
+        """Initialize a Sargin Material.
+
+        Arguments:
+            fc (float): The strength of concrete in compression
+
+        Keyword Arguments:
+            eps_c1 (float): Peak strain of concrete in compression. Default
+                value = -0.0023.
+            eps_u (float): Ultimate strain of concrete in compression. Default
+                value = -0.0035.
+            k (float): Plasticity number. Default value = 2.04.
+            name (str): A name for the constitutive law.
+
+        Raises:
+            ValueError: If k is less or equal to 0.
+
+        Note:
+            If positive values are input for fc, eps_c1 and eps_cu1 are input,
+            they will be assumed negative.
+        """
+        name = name if name is not None else 'SarginLaw'
+        super().__init__(name=name)
+        self._fc = -abs(fc)
+        self._eps_c1 = -abs(eps_c1)
+        self._eps_cu1 = -abs(eps_cu1)
+        self._k = k
+
+    def get_stress(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the stress given the strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # Preprocess eps array in order
+        eps = self.preprocess_strains_with_limits(eps=eps)
+        # Compute stress
+        # Polynomial branch
+        eta = eps / self._eps_c1
+
+        sig = self._fc * (self._k * eta - eta**2) / (1 + (self._k - 2) * eta)
+
+        # Elsewhere stress is 0.0
+        if np.isscalar(eps):
+            if eps < self._eps_cu1 or eps > 0:
+                return 0.0
+        else:
+            sig[eps < self._eps_cu1] = 0.0
+            sig[eps > 0] = 0.0
+
+        return sig
+
+    def get_tangent(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the tangent given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # polynomial branch
+        eta = eps / self._eps_c1
+
+        tangent = (
+            self._fc
+            / self._eps_c1
+            * ((2 - self._k) * eta**2 - 2 * eta + self._k)
+            / (1 + (self._k - 2) * eta) ** 2
+        )
+        # Elsewhere tangent is zero
+        if np.isscalar(eps):
+            if eps < self._eps_cu1 or eps > 0:
+                return 0
+        else:
+            tangent[eps < self._eps_cu1] = 0.0
+            tangent[eps > 0] = 0.0
+
+        return tangent
+
+    def get_ultimate_strain(
+        self, yielding: bool = False
+    ) -> t.Tuple[float, float]:
+        """Return the ultimate strain (negative and positive)."""
+        if yielding:
+            return (self._eps_c1, 100)
+        return (self._eps_cu1, 100)

structuralcodes/materials/constitutive_laws/_userdefined.py

@@ -0,0 +1,218 @@
+"""User defined constitutive law."""
+
+from __future__ import annotations  # To have clean hints of ArrayLike in docs
+
+import typing as t
+
+import numpy as np
+from numpy.typing import ArrayLike
+
+from ...core.base import ConstitutiveLaw
+
+
+class UserDefined(ConstitutiveLaw):
+    """Class for a user defined constitutive law.
+
+    The curve is defined with positive and optionally negative values. After
+    the last value, the stress can go to zero to simulate failure (default), or
+    be maintained constante, or the last tanget or secant values may be
+    maintained indefinetely. The flag parameter controls this behavior.
+    """
+
+    __materials__: t.Tuple[str] = ('concrete', 'steel', 'rebars')
+
+    def __init__(
+        self,
+        x: ArrayLike,
+        y: ArrayLike,
+        name: t.Optional[str] = None,
+        flag: int = 0,
+    ) -> None:
+        """Initialize a UserDefined constitutive law.
+
+        Arguments:
+            x (ArrayLike): Data for strains.
+            y (ArrayLike): Data for stresses. Must be of same length as x.
+
+        Keyword Arguments:
+            name (Optional, str): A name for the constitutive law.
+            flag (Optional): A flag specifying the behavior after the last
+                point. Admissible values: 0 (default): stress drops to zero
+                after ultimate strain, 1: stress is mantained constant, 2:
+                last tangent is used, 3: last secant is used.
+        """
+        name = name if name is not None else 'UserDefinedLaw'
+        super().__init__(name=name)
+        x = np.atleast_1d(np.asarray(x))
+        y = np.atleast_1d(np.asarray(y))
+        if len(x) != len(y):
+            raise ValueError('The two arrays should have the same length')
+        if not np.any(x < 0):
+            # User provided only positive part, reflect in negative
+            self._x = np.concatenate((-np.flip(x)[:-1], x))
+            self._y = np.concatenate((-np.flip(y)[:-1], y))
+        else:
+            # User gave both positive and negative parts
+            self._x = x
+            self._y = y
+        # Define what happens after last strain
+        if flag not in (0, 1, 2, 3):
+            raise ValueError('Flag can assume values 0, 1, 2 or 3.')
+        self._ultimate_strain_p = self._x[-1]
+        self._ultimate_strain_n = self._x[0]
+        if flag in (1, 2, 3):
+            x = np.insert(self._x, 0, self._x[0] * 100)
+            x = np.append(x, self._x[-1] * 100)
+            if flag == 1:
+                y = np.insert(self._y, 0, self._y[0])
+                y = np.append(y, self._y[-1])
+            elif flag == 2:
+                tangent_p = (self._y[-1] - self._y[-2]) / (
+                    self._x[-1] - self._x[-2]
+                )
+                tangent_n = (self._y[1] - self._y[0]) / (
+                    self._x[1] - self._x[0]
+                )
+                y = np.insert(
+                    self._y, 0, (x[0] - x[1]) * tangent_n + self._y[0]
+                )
+                y = np.append(y, (x[-1] - x[-2]) * tangent_p + self._y[-1])
+            elif flag == 3:
+                secant_p = self._y[-1] / self._x[-1]
+                secant_n = self._y[0] / self._x[0]
+                y = np.insert(
+                    self._y, 0, (x[0] - x[1]) * secant_n + self._y[0]
+                )
+                y = np.append(y, (x[-1] - x[-2]) * secant_p + self._y[-1])
+            self._x = x
+            self._y = y
+
+        # Compute slope of each segment
+        self._slopes = np.diff(self._y) / np.diff(self._x)
+
+    def get_stress(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the stress given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+        # Preprocess eps array in order
+        eps = self.preprocess_strains_with_limits(eps=eps)
+        # Compute stress
+        return np.interp(eps, self._x, self._y, left=0, right=0)
+
+    def get_tangent(
+        self, eps: t.Union[float, ArrayLike]
+    ) -> t.Union[float, ArrayLike]:
+        """Return the tangent given strain."""
+        eps = eps if np.isscalar(eps) else np.atleast_1d(eps)
+
+        # Find the segment index for each x value
+        indices = np.searchsorted(self._x, eps) - 1
+
+        # Check that indices are within vlaid range
+        indices = np.clip(indices, 0, len(self._slopes) - 1)
+
+        # Get the corresponding slopes
+        tangent = self._slopes[indices]
+
+        # Elsewhere tangent is zero
+        if np.isscalar(eps):
+            if eps < self._x[0] or eps > self._x[-1]:
+                tangent = 0
+        else:
+            tangent[eps < self._x[0]] = 0.0
+            tangent[eps > self._x[-1]] = 0.0
+
+        return tangent
+
+    def __marin__(
+        self, strain: t.Tuple[float, float]
+    ) -> t.Tuple[t.List[t.Tuple], t.List[t.Tuple]]:
+        """Returns coefficients and strain limits for Marin integration in a
+        simply formatted way.
+
+        Arguments:
+            strain (float, float): Tuple defining the strain profile: eps =
+                strain[0] + strain[1]*y.
+
+        Example:
+            [(0, -0.002), (-0.002, -0.003)]
+            [(a0, a1, a2), (a0)]
+        """
+        strains = []
+        coeff = []
+        if strain[1] == 0:
+            # Uniform strain equal to strain[0]
+            # understand in which branch are we
+            strain[0] = self.preprocess_strains_with_limits(strain[0])
+            found = False
+            for i in range(len(self._x) - 1):
+                if self._x[i] <= strain[0] and self._x[i + 1] >= strain[0]:
+                    strains = None
+                    stiffness = (self._y[i + 1] - self._y[i]) / (
+                        self._x[i + 1] - self._x[i]
+                    )
+                    a0 = stiffness * (strain[0] - self._x[i]) + self._y[i]
+                    a1 = stiffness * strain[1]
+                    coeff.append((a0, a1))
+                    found = True
+                    break
+            if not found:
+                strains = None
+                coeff.append((0.0,))
+        else:
+            for i in range(len(self._x) - 1):
+                # For each branch of the linear piecewise function
+                stiffness = (self._y[i + 1] - self._y[i]) / (
+                    self._x[i + 1] - self._x[i]
+                )
+                strains.append((self._x[i], self._x[i + 1]))
+                a0 = stiffness * (strain[0] - self._x[i]) + self._y[i]
+                a1 = stiffness * strain[1]
+                coeff.append((a0, a1))
+
+        return strains, coeff
+
+    def get_ultimate_strain(self, **kwargs) -> t.Tuple[float, float]:
+        """Return the ultimate strain (negative and positive)."""
+        del kwargs
+        return (self._ultimate_strain_n, self._ultimate_strain_p)
+
+    def set_ultimate_strain(
+        self, eps_su=t.Union[float, t.Tuple[float, float]]
+    ) -> None:
+        """Set ultimate strains for Elastic Material if needed.
+
+        Arguments:
+            eps_su (float or (float, float)): Defining ultimate strain. If a
+                single value is provided the same is adopted for both negative
+                and positive strains. If a tuple is provided, it should be
+                given as (negative, positive).
+        """
+        if isinstance(eps_su, float):
+            self._ultimate_strain_p = abs(eps_su)
+            self._ultimate_strain_n = -abs(eps_su)
+        elif isinstance(eps_su, tuple):
+            if len(eps_su) < 2:
+                raise ValueError(
+                    'Two values need to be provided when setting the tuple'
+                )
+            eps_su_n = eps_su[0]
+            eps_su_p = eps_su[1]
+            if eps_su_p < eps_su_n:
+                eps_su_p, eps_su_n = eps_su_n, eps_su_p
+            if eps_su_p < 0:
+                raise ValueError(
+                    'Positive ultimate strain should be non-negative'
+                )
+            if eps_su_n > 0:
+                raise ValueError(
+                    'Negative utimate strain should be non-positive'
+                )
+            self._ultimate_strain_p = eps_su_p
+            self._ultimate_strain_n = eps_su_n
+        else:
+            raise ValueError(
+                'set_ultimate_strain requires a single value or a tuple \
+                with  two values'
+            )