J2CyclicBoundingSurfaceMaterial
A material model that implements the J2 Cyclic Bounding Surface plasticity model, useful for modeling cyclical response in soil and other materials with complex hardening behavior.
Parameters:
Parameter |
Description |
Type |
---|---|---|
G |
Shear modulus (required) |
float |
K |
Bulk modulus (required) |
float |
Su |
Undrained shear strength (required) |
float |
Den |
Mass density (required) |
float |
h |
Hardening parameter (required) |
float |
m |
Hardening exponent (required) |
float |
h0 |
Initial hardening parameter (required) |
float |
chi |
Initial damping (viscous). chi = 2*dr_o/omega (dr_o = damping ratio at zero strain, omega = angular frequency) (required) |
float |
beta |
Integration variable (0 = explicit, 1 = implicit, 0.5 = midpoint rule) (default = 0.5) |
float |
Example
# Direct creation
from femora.components.Material.materialsOpenSees import J2CyclicBoundingSurfaceMaterial
j2_material = J2CyclicBoundingSurfaceMaterial(
user_name="Clay",
G=1.3e6, # Shear modulus (Pa)
K=2.6e6, # Bulk modulus (Pa)
Su=18000, # Undrained shear strength (Pa)
Den=1800, # Mass density (kg/m³)
h=1.5, # Hardening parameter
m=0.6, # Hardening exponent
h0=0.5, # Initial hardening parameter
chi=0.1, # Initial damping
beta=0.5 # Integration variable (midpoint rule)
)
or
# Via Femora
import femora as fm
fm.material.create_material(
material_category="nDMaterial",
material_type="J2CyclicBoundingSurface",
user_name="Clay",
G=1.3e6,
K=2.6e6,
Su=18000,
Den=1800,
h=1.5,
m=0.6,
h0=0.5,
chi=0.1
)