From d545b36bad37b4b164eae40a3bf1cb6e6401d256 Mon Sep 17 00:00:00 2001 From: Silvia Mazzoni Date: Tue, 3 Feb 2026 18:15:55 -0800 Subject: [PATCH 1/3] Update HystereticSM.rst added Feb 2026 update. --- .../material/uniaxialMaterials/HystereticSM.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst index 0ae2853a..d32805ed 100644 --- a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst +++ b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst @@ -8,6 +8,8 @@ This command is used to construct a uniaxial multilinear hysteretic material obj - The positive and negative backbone of this material do not need to have the same number of segments. - This material also has the option to degrade the envelope using the degEnv parameters -- these parameters must be used in combination with the damage parameters - This material also has additional DCR-type recorder output (this is still a work in progress). +- Feb 2026 Update 1: I added a new input rotY to be used when the deformation represents platic-only deformation. The user-defined values of rotY is added to eps1 to compute the current ductility level (=current strain/(eps1+rotY)). You can define different values in positive and negative. This new argument affects the damage-parameter calcs as well as the unloading stiffness. +- Feb 2026 Update 2: The second slope no longer needs to be positive, only the first stiffness does... in both directions. Input Command: ----------------- @@ -23,6 +25,7 @@ Input Command: <,'-damage',damage1,damage2> <,'-beta',beta> <,'-degEnv',degEnvP <,degEnvN>> + <,'-rotY',rotYp <,rotYn>> <,'-defoLimitStates',lsD1 <$lsD2>...> <,'-forceLimitStates',lsF1 <,$lsF2>...> <,'-printInput'> @@ -40,6 +43,7 @@ Input Command: <-damage $damage1 $damage2> \ <-beta $beta> \ <-degEnv degEnvP > \ + <-rotY rotYp > \ <-defoLimitStates $lsD1 <$lsD2>...> \ <-forceLimitStates $lsF1 <$lsF2>...> \ <-printInput> \ @@ -55,6 +59,7 @@ You can use the following input format as it is compatible with Hysteretic mater s1n,e1n,s2n,e2n <,s3n,e3n> <,s4n,e4n> <,s5n,e5n> <,s6n,e6n> <,s7n,e7n>, pinchX,pinchY,damage1,damage2 <,beta> <,'-degEnv',degEnvP <,degEnvN>> + <,'-rotY',rotYp <,rotYn>> <,'-defoLimitStates',lsD1 <$lsD2>...> <,'-forceLimitStates',lsF1 <,$lsF2>...> <,'-printInput'> @@ -68,6 +73,7 @@ You can use the following input format as it is compatible with Hysteretic mater $s1n $e1n $s2n $e2n <$s3n $e3n> <$s4n $e4n> <$s5n $e5n> <$s6n $e6n> <$s7n $e7n> \ $pinchX $pinchY $damage1 $damage2 <$beta> \ <-degEnv degEnvP > \ + <-rotY rotYp > \ <-defoLimitStates lsD1? ...> \ <-forceLimitStates lsF1? ...> \ <-printInput> \ @@ -131,6 +137,12 @@ Input Arguments: * - $degEnvN - |float| - envelope-degredation factor. This factor works with the damage parameters to degrade the NEGATIVE envelope. A positive value degrades both strength and strain values, a negative values degrades only strength. The factor is applied to points 3+ (optional, default=degEnvP, if defined, =0. otherwise) + * - $rotYp + - |float| + - This value is added to e1p anytime the algorithm needs to compute ductility or energy in POSITIVE direction. + * - $rotYn + - |float| + - This value is added to e1p anytime the algorithm needs to compute ductility or energy in NEGATIVE direction. * - ($lsD1,$lsD2..) - |float| - list of user-defined strain/deformation limits for computing deformation DCRs (optional) @@ -731,3 +743,4 @@ Input-Parameters Study: | HystereticSM Code Developed (2022) by: |silvia| (Silvia's Brainery) | Original Hysteretic-Material Code Developed by: |mhs| & Filip Filippou (UC Berkeley) + From 2f65976b8e865832e5dfa5cb317ea3779810a4cb Mon Sep 17 00:00:00 2001 From: Silvia Mazzoni Date: Wed, 4 Feb 2026 15:13:36 -0800 Subject: [PATCH 2/3] Update HystereticSM.rst --- .../user/manual/material/uniaxialMaterials/HystereticSM.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst index d32805ed..10c52408 100644 --- a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst +++ b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst @@ -4,10 +4,11 @@ HystereticSM Material ^^^^^^^^^^^^^^^^^^^^^ This command is used to construct a uniaxial multilinear hysteretic material object with pinching of force and deformation, damage due to ductility and energy, and degraded unloading stiffness based on ductility. -- This material is an extension of the Hysteretic Material -- the envelope can be defined 2,3, 4,5,6 or 7 points, while the original one only had 2 or 3. +- This material is an extension of the Hysteretic Material -- the envelope can be defined 2,3,4,5,6 or 7 points, while the original one only had 2 or 3. - The positive and negative backbone of this material do not need to have the same number of segments. - This material also has the option to degrade the envelope using the degEnv parameters -- these parameters must be used in combination with the damage parameters - This material also has additional DCR-type recorder output (this is still a work in progress). +- Written by Silvia Mazzoni, 2022 - Feb 2026 Update 1: I added a new input rotY to be used when the deformation represents platic-only deformation. The user-defined values of rotY is added to eps1 to compute the current ductility level (=current strain/(eps1+rotY)). You can define different values in positive and negative. This new argument affects the damage-parameter calcs as well as the unloading stiffness. - Feb 2026 Update 2: The second slope no longer needs to be positive, only the first stiffness does... in both directions. @@ -741,6 +742,7 @@ Input-Parameters Study: -| HystereticSM Code Developed (2022) by: |silvia| (Silvia's Brainery) +| HystereticSM Code Developed (2022) by: |Silvia Mazzoni| (Silvia's Brainery) | Original Hysteretic-Material Code Developed by: |mhs| & Filip Filippou (UC Berkeley) + From f988adcb93156d20e89c7aa1452353cecb5fce03 Mon Sep 17 00:00:00 2001 From: Silvia Mazzoni Date: Wed, 4 Feb 2026 15:14:26 -0800 Subject: [PATCH 3/3] Update HystereticSM.rst --- .../user/manual/material/uniaxialMaterials/HystereticSM.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst index 10c52408..d2077d92 100644 --- a/source/user/manual/material/uniaxialMaterials/HystereticSM.rst +++ b/source/user/manual/material/uniaxialMaterials/HystereticSM.rst @@ -134,10 +134,10 @@ Input Arguments: - power used to determine the degraded unloading stiffness based on ductility, mu-beta (optional, default=0.0) * - $degEnvP - |float| - - envelope-degredation factor. This factor works with the damage parameters to degrade the POSITIVE envelope. A positive value degrades both strength and strain values, a negative values degrades only strength. The factor is applied to points 3+ (optional, default=0.0) + - envelope-degredation factor. This factor works with the damage parameters to degrade the POSITIVE envelope. A positive value degrades both strength and strain values, a negative values degrades only strength. The factor is applied to points 2+ (optional, default=0.0) * - $degEnvN - |float| - - envelope-degredation factor. This factor works with the damage parameters to degrade the NEGATIVE envelope. A positive value degrades both strength and strain values, a negative values degrades only strength. The factor is applied to points 3+ (optional, default=degEnvP, if defined, =0. otherwise) + - envelope-degredation factor. This factor works with the damage parameters to degrade the NEGATIVE envelope. A positive value degrades both strength and strain values, a negative values degrades only strength. The factor is applied to points 2+ (optional, default=degEnvP, if defined, =0. otherwise) * - $rotYp - |float| - This value is added to e1p anytime the algorithm needs to compute ductility or energy in POSITIVE direction. @@ -746,3 +746,4 @@ Input-Parameters Study: | Original Hysteretic-Material Code Developed by: |mhs| & Filip Filippou (UC Berkeley) +