suanPan-manual
  • Introduction
  • Basic
    • Obtain Application
    • Configure Application
    • Perform Analysis
    • Model Syntax
    • Model Structure
    • Tweak Performance
    • Compile Application
    • Build Documentation
    • Architecture Design
    • On Clusters
  • Example
    • Developer
      • element template
      • material template
    • Solid
      • wave propagation
    • Geotechnical
      • triaxial compression of sand
      • slope analysis
    • Structural
      • Statics
        • bending of a cantilever beam
        • bifurcation of a cantilever beam
        • double-edge notched specimen
        • lees frame
        • notched beam under cyclic loading
        • rc section analysis
        • truss roof
        • uniform tension of a rubber specimen
        • thin-walled section analysis for frame structures
        • calibration of subloading surface model
      • Dynamics
        • bouncing of a ball
        • mass-spring-dashpot system
        • dynamic analysis of a portal frame
        • elemental damping
        • particle collision
        • response history analysis of an elastic coupled wall
        • multi-support excitation
        • triple pendulum
        • computing response spectrum
        • integrate with python
        • process ground motion
      • Hybrid
        • vibration of a displaced beam
      • Buckling
        • buckling analysis of a cantilever beam
      • Contact
        • contact between beam and block
        • contact in 3d space
      • Optimization
        • evolutionary structural optimization
      • Isogeometric Analysis
        • linear analysis of a single element
    • Miscellaneous
      • batch execution for automation
  • Command Collection
    • Define
      • amplitude
      • bc
      • domain
      • element
      • expression
      • file
      • generate
      • group
      • import
      • initial
      • load
      • material
      • modifier
      • node
      • recorder
      • section
    • Configure
      • analyze
      • converger
      • criterion
      • integrator
      • precheck
      • step
    • Process
      • benchmark
      • clear
      • command
      • enable
      • exit
      • materialtest
      • materialtestbyload
      • sectiontest
      • peek
      • plot
      • protect
      • pwd
      • reset
      • save
      • set
      • upsampling
      • sdof_response
      • response_spectrum
  • Amplitude
    • Amplitude
    • Special
      • NZStrongMotion
    • Universal
      • Combine
      • Constant
      • Decay
      • Linear
      • Modulated
      • Tabular
      • TabularSpline
      • Trig
  • Constraint
    • MPC
    • ParticleCollision
    • RigidWall
    • RestitutionWall
    • FixedLength
    • MaxForce
    • NodeLine
    • NodeFacet
    • Embed2D
    • Embed3D
    • LJPotential2D
    • MaximumGap2D
    • MinimumGap2D
    • MaximumGap3D
    • MinimumGap3D
  • Converger
    • Converger
    • Absolute
      • AbsDisp
      • AbsError
      • AbsIncreDisp
      • AbsIncreAcc
      • AbsIncreEnergy
      • AbsResidual
    • Other
      • FixedNumber
      • Logic
    • Relative
      • RelDisp
      • RelError
      • RelIncreDisp
      • RelIncreAcc
      • RelIncreEnergy
      • RelResidual
  • Criterion
    • Criterion
    • MaxDisplacement
    • MaxHistory
    • MaxResistance
    • MinDisplacement
    • MinResistance
    • StrainEnergyEvolution
  • Element
    • Beam
      • B21
      • B21E
      • B21H
      • B31
      • B31OS
      • EB21
      • EB31OS
      • F21
      • F21H
      • F31
      • NMB21
      • NMB21E
      • NMB31
      • MVLEM
      • Orientation
    • Cube
      • C3D20
      • C3D4
      • C3D8
      • C3D8I
      • CIN3D8
      • DC3D4
      • DC3D8
    • Membrane
      • Couple Stress
      • Phase Field
        • DCP3
        • DCP4
      • Axisymmetric
        • CAX3
        • CAX4
        • CAX8
      • Plane
        • CP3
        • CP4
        • CP4I
        • CP5
        • CP6
        • CP7
        • CP8
      • Mixed
        • PS
        • QE2
      • Drilling
        • Allman
        • GCMQ
        • GQ12
      • Infinite
        • CINP4
      • Geotechnical
        • PCPE4DC
        • PCPE4UC
        • PCPE8DC
        • PCPE8UC
      • Membrane
    • Modifier
      • Modifier
      • ElementalLee
      • ElementalNonviscous
      • LinearViscosity
    • Patch
      • Patch
      • PatchCube
      • PatchQuad
    • Plate
      • DKT3
      • DKT4
      • Mindlin
    • Shell
      • DKTS3
      • DKTS4
      • S4
      • SGCMS
      • ShellBase
    • Special
      • Contact2D
      • Contact3D
      • Damper01
      • Damper02
      • Embedded2D
      • Embedded3D
      • Joint
      • Mass
      • SingleSection
      • Spring01
      • Spring02
      • Tie
      • TranslationConnector
    • Truss
      • T2D2
      • T2D2S
      • T3D2
      • T3D2S
  • Group
    • CustomNodeGroup
    • NodeGroup
    • ElementGroup
    • GroupGroup
  • Integrator
    • Implicit
      • Linear
      • BatheTwoStep
      • GeneralizedAlpha
      • OALTS
      • GSSSS
      • Newmark
        • LeeNewmark
        • LeeElementalNewmark
        • LeeNewmarkFull
        • LeeNewmarkIterative
        • Newmark
        • RayleighNewmark
        • WilsonPenzienNewmark
        • NonviscousNewmark
    • Explicit
      • Tchamwa
      • BatheExplicit
      • GeneralizedAlphaExplicit
  • Material
    • Guide
      • Metal
      • Customisation
    • Material1D
      • Concrete
        • ConcreteCM
        • ConcreteExp
        • ConcreteTsai
        • ConcreteTable
        • ConcreteK4
      • Degradation
        • Degradation
        • CustomStrainDegradation
        • CustomStressDegradation
        • Dhakal
        • TrilinearStrainDegradation
      • Elastic
        • BilinearElastic1D
        • Elastic1D
        • AsymmElastic1D
        • MultilinearElastic1D
        • PolyElastic1D
        • NLE1D01
        • Sinh1D
        • Tanh1D
        • CustomElastic1D
      • Hysteresis
        • AFC
        • AFCN
        • BilinearOO
        • BilinearPO
        • BoucWen
        • BWBN
        • Flag
        • MPF
        • MultilinearOO
        • MultilinearPO
        • RambergOsgood
        • SimpleHysteresis
        • SlipLock
        • SteelBRB
        • Trivial
        • Gap01
      • Viscosity
        • Kelvin
        • Maxwell
        • NonlinearViscosity
        • BilinearViscosity
        • CustomViscosity
        • Viscosity01
        • Viscosity02
        • CoulombFriction
        • Nonviscous01
      • vonMises
        • Subloading1D
        • ArmstrongFrederick1D
        • AFCO1D
        • Bilinear1D
        • BilinearMises1D
        • CustomGurson1D
        • CustomMises1D
        • ExpGurson1D
        • ExpMises1D
        • Mises1D
        • Multilinear1D
        • NonlinearGurson1D
        • VAFCRP1D
    • Material2D
      • AxisymmetricElastic
      • Concrete21
      • Concrete22
      • DuncanSelig
      • Elastic2D
      • Rebar2D
    • Material3D
      • CamClay
        • BilinearCC
        • ExpCC
        • NonlinearCamClay
        • ParabolicCC
      • Concrete
        • CDP
        • CDPM2
        • Rebar3D
        • TableCDP
        • CustomCDP
      • Damage
        • IsotropicDamage
        • LinearDamage
      • DruckerPrager
        • BilinearDP
        • ExpDP
        • CustomDP
        • NonlinearDruckerPrager
      • Elastic
        • BlatzKo
        • IsotropicElastic3D
        • IsotropicNonlinearElastic3D
        • MooneyRivlin
        • NLE3D01
        • OrthotropicElastic3D
        • Yeoh
      • Hoffman
        • BilinearHoffman
        • ExpHoffman
        • CustomHoffman
        • NonlinearHill
        • NonlinearHoffman
        • TimberPD
      • Sand
        • SimpleSand
        • DafalisaManzari
      • vonMises
        • ArmstrongFrederick
        • BilinearJ2
        • BilinearPeric
        • CustomGurson
        • TableGurson
        • CustomJ2
        • ExpGurson
        • ExpJ2
        • MultilinearJ2
        • NonlinearGurson
        • NonlinearJ2
        • NonlinearPeric
        • PolyJ2
        • VAFCRP
        • Subloading
    • MaterialOS
      • ElasticOS
    • Wrapper
      • Axisymmetric
      • Laminated
      • Parallel
      • PlaneStrain
      • PlaneSymmetric
      • PlaneStress
      • Rotation2D
      • Rotation3D
      • Sequential
      • Stacked
      • Uniaxial
      • OS146
      • OS146S
      • Substepping
  • Recorder
    • Recorder
    • OutputType
  • Section
    • Code
      • EU
      • NZ
      • US
    • Section1D
      • Circle1D
      • Fibre1D
      • Rectangle1D
      • TrussSection
    • Section2D
      • Bar2D
      • Box2D
      • Circle2D
      • CircularHollow2D
      • Fibre2D
      • HSection2D
      • ISection2D
      • Rectangle2D
      • TSection2D
    • Section3D
      • Bar3D
      • Box3D
      • Circle3D
      • CircularHollow3D
      • Fibre3D
      • ISection3D
      • Rectangle3D
      • TSection3D
    • SectionOS
      • Cell3DOS
      • Fibre3DOS
    • SectionNM
      • SectionNM
      • NM2D1
      • NM2D2
      • NM2D3
      • NM2D3K
      • NM3D1
      • NM3D2
      • NM3D3
      • NM3D3K
  • Solver
    • BFGS
    • MPDC
    • Newton
    • AICN
    • Ramm
  • Step
    • Overview
    • ArcLength
    • Buckle
    • Dynamic
    • Frequency
    • Optimization
    • Static
  • Developer
    • Prerequisites
    • C Style Interface
      • material
    • CPP Style Interface
      • material
      • element
      • constraint
Powered by GitBook
On this page
  • Syntax
  • History Variable Layout
  • Theory
  • Parameters
  • Examples
  • Vanilla Model
  • Strength degradation
  • Stiffness degradation
  • Pinching Effect
Edit on GitHub
  1. Material
  2. Material1D
  3. Hysteresis

BWBN

Bouc-Wen-Baber-Noori Model

The BWBN model is an extension of the BoucWen model with stiffness degradation, strength degradation and pinching effect.

Syntax

material BWBN (1) [2...18]
# (1) int, unique material tag
# [2] double, elastic modulus, default: 2E5
# [3] double, yield stress, default: 4E2
# [4] double, hardening ratio, default: 1E-2
# [5] double, \beta (>0), default: 0.5
# [6] double, exponent n (>0, normally >=1), default: 1.0
# [7] double, initial \nu (>0), default: 1.0
# [8] double, slope of \nu (>0), default: 0.0
# [9] double, initial \eta (>0), default: 1.0
# [10] double, slope of \eta (>0), default: 0.0
# [11] double, initial \phi (>0), default: 1.0
# [12] double, slope of \phi (>0), default: 0.0
# [13] double, \zeta (1>\zeta>0), default: 0.0
# [14] double, slope of A (>0), default: 0.0
# [15] double, p (>0), default: 0.0
# [16] double, q (>0), default: 0.0
# [17] double, \lambda (>0), default: 1.0
# [18] double, density, default: 0.0

History Variable Layout

location
value

initial_history(0)

z

Theory

The evolution of internal displacement z(t)z(t)z(t) is governed by the differential equation,

ηΔz=hΔuuy(A−ν(γ+sign(z⋅Δu)β)∣z∣n).\eta\Delta{}z=h\dfrac{\Delta{}u}{u_y}\left(A-\nu\left(\gamma+\text{sign}\left(z\cdot\Delta{}u\right)\beta\right) \Big|z\Big|^n\right).ηΔz=huy​Δu​(A−ν(γ+sign(z⋅Δu)β)​z​n).

Then,

F=aFyuuy+(1−a)Fyz.F=aF_y\dfrac{u}{u_y}+\left(1-a\right)F_yz.F=aFy​uy​u​+(1−a)Fy​z.

For state determination, zzz is solved iteratively by using the Newton method. The evolutions of internal functions rely on the dissipated energy eee, which is defined to be a normalized quantity.

e=(1−a)∫z du.e=\left(1-a\right)\int{}z~\mathrm{d}u.e=(1−a)∫z du.

The trapezoidal rule is used so that

Δe=(1−a)2z+Δz2Δu.\Delta{}e=\left(1-a\right)\dfrac{2z+\Delta{}z}{2}\Delta{}u.Δe=(1−a)22z+Δz​Δu.

The evolutions are

ν=ν0+δνe,η=η0+δηe,A=1−δAe,h=1−ζ1exp⁡(−(z⋅sign(Δu)−qzuζ2)2),ζ1=ζ(1−exp⁡(−pe)),ζ2=(ϕ0+δϕe)(λ+ζ1),zu=1νn=ν−1/n.\begin{align*} \nu&=\nu_0+\delta_\nu{}e,\\[3mm] \eta&=\eta_0+\delta_\eta{}e,\\[3mm] A&=1-\delta_Ae,\\[3mm] h&=1-\zeta_1\exp\left(-\left(\dfrac{z\cdot\text{sign}\left(\Delta{}u\right)-qz_u}{\zeta_2}\right)^2\right),\\[3mm] \zeta_1&=\zeta\left(1-\exp\left(-pe\right)\right),\\[3mm] \zeta_2&=\left(\phi_0+\delta_\phi{}e\right)\left(\lambda+\zeta_1\right),\\[3mm] z_u&=\sqrt[n]{\dfrac{1}{\nu}}=\nu^{-1/n}. \end{align*}νηAhζ1​ζ2​zu​​=ν0​+δν​e,=η0​+δη​e,=1−δA​e,=1−ζ1​exp(−(ζ2​z⋅sign(Δu)−qzu​​)2),=ζ(1−exp(−pe)),=(ϕ0​+δϕ​e)(λ+ζ1​),=nν1​​=ν−1/n.​

Parameters

Strength degradation is controlled by uuu. To disable it, set δν=0\delta_\nu=0δν​=0.

Stiffness degradation is controlled by η\etaη. To disable it, set δη=0\delta_\eta=0δη​=0.

Pinching is controlled by hhh. To disable it, set ζ=0\zeta=0ζ=0 or p=0p=0p=0.

Examples

Vanilla Model

The default behavior is similar to a bilinear hardening material.

material BWBN 1
materialtest1d 1 4E-4 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 80

Strength degradation

A positive δν\delta_\nuδν​ enables strength degradation.

material BWBN 1 2E5 4E2 0 .5 1. 1. 1E0 1. 0. 1. 0. 0. 0. 0. 0. 1. 0.
materialtest1d 1 4E-4 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 80

A positive δA\delta_AδA​ has the similar effect.

material BWBN 1 2E5 4E2 0 .5 1. 1. 0. 1. 0. 1. 0. 0. 1E0 0. 0. 1. 0.
materialtest1d 1 4E-4 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 80

Stiffness degradation

A positive δη\delta_\etaδη​ enables stiffness degradation.

material BWBN 1 2E5 4E2 0 .5 1 1 0 1 1E1 1 0 1 0 1 1 0 0
materialtest1d 1 4E-4 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 80

Pinching Effect

The pinching effect is governed by ϕ0\phi_0ϕ0​, δϕ\delta_\phiδϕ​, ζ\zetaζ, ppp, qqq and λ\lambdaλ.

material BWBN 1 2E5 4E2 0 .5 1. 1. 0. 1. 0. 1. 1E1 1. 0. 1E1 1E0 1. 0.
materialtest1d 1 1E-3 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 80
PreviousBoucWenNextFlag

Last updated 3 years ago

The page contains sufficient information about the formulation of BWBN model. Some normalizations are carried out compared to the original model.

Wikipedia
vanilla model
strength degradation
strength degradation
stiffness degradation
pinching effect