Skip to content

Material Selection & Full Catalog

materials-selectionApplies to create / edit~980 tokens

The desktop AI reads from the same knowledge base — this page is its English edition. When the AI cites 📖 guide · materials-selection in a conversation, it refers to this entry.

In One Sentence

Selecting a material is not “use whichever is most advanced.” It’s fixed in three steps: first, element type decides the layer (uniaxial/multiaxial); second, loading regime decides the complexity (monotonic/cyclic); third, member type decides the model.

Step 1: Element Type Decides the Layer

Element Material layer Notes
elasticBeamColumn / forceBeamColumn / dispBeamColumn Uniaxial Material attaches to a fiber section
truss / corotTruss Uniaxial Assigned directly to the element
zeroLength / twoNodeLink Uniaxial Bearings, dampers, contact
ShellMITC4 / ShellDKGQ Multiaxial Thick shells; material assigned to the element
LayeredShell Uniaxial Layered shell; one uniaxial material per layer
stdBrick / SSPBrick / FourNodeQuad Multiaxial Solid elements

Get the layer wrong and everything after it is wrong. This step cannot be guessed—look at the element type, not what the member is called.

Steps 2 + 3: Scenario Quick Reference

Member / Scenario Material Why Detailed parameters
Steel beams and columns (static) Steel01 Monotonic loading; bilinear suffices 📖 guide · materials-steel
Steel beams and columns (seismic, Pushover) Steel02 Cyclic loading must capture the Bauschinger effect Same as above
Steel member buckling / collapse Steel04 Has buckling branch and fracture criterion Same as above
Rebar (inside concrete members) Steel02 Rebar hysteresis is pronounced under cyclic loading Same as above
RC beams and slabs Concrete02 Needs a tension-softening branch 📖 guide · materials-concrete
Column core (with stirrups) Concrete04 / Concrete07 Confined concrete; strength and ductility both increase Same as above
Column cover Concrete01 / Concrete02 Unconfined; ultimate strain 0.0033 Same as above
Shear wall (layered shell) Concrete02 + Steel02 One uniaxial material per layer Same as above
Shear wall (solid) ElasticIsotropic / J2Plasticity / DruckerPrager Multiaxial layer See multiaxial list below
Masonry wall Hysteretic or ElasticPP + equivalent diagonal strut No dedicated masonry constitutive model; use equivalence See below
Elastomeric isolation bearing ElastomericBearingPlasticity element or Hysteretic Shear hysteresis See below
Friction pendulum bearing FrictionModel + FlatSliderBearing Friction coefficient + pendulum restoring force See below
Viscous damper ViscousDamper or Viscous material Velocity-dependent See below
Metallic yield damper Steel01 / Steel02 + zero-length element Mild-steel yielding dissipates energy —
Prestressed cable ElasticPP (tension-only) or TensionOnly wrapper Cables cannot carry compression See below
Pile-soil interaction PySimple1 / TzSimple1 / QzSimple1 p-y, t-z, q-z curves See below
Sand liquefaction PM4Sand / PressureDependMultiYield Multiaxial; pore pressure buildup See below
Clay dynamics PM4Silt / PressureIndependMultiYield Multiaxial; undrained See below
Load path verification only Elastic Just E; fastest —
Quick concept comparison Elastic + amplification factor Don’t fake it with complex constitutive models —

The 10 Most Commonly Used (Learn These First)

Material Purpose in one sentence Key parameters
Elastic Linear elastic; just E E
ElasticPP Elastic-perfectly-plastic (no hardening) E, σy
Hardening Bilinear with isotropic + kinematic hardening E, σy, Hiso, Hkin
Steel01 Bilinear + isotropic hardening (steel) fy, E, b
Steel02 Menegotto-Pinto + kinematic hardening (steel) fy, E, b, R0, cR1, cR2
Concrete01 Concrete in compression (no tension) f′c, εc0, f′cu, εu
Concrete02 Concrete compression + tension softening Above + ft, Ets, λ
Concrete04 Smooth Popovics concrete f′c, εc0, εcu, Ec, ft, εt
Hysteretic General multilinear hysteresis (trilinear backbone) Three points each direction + pinching + damage
ElasticIsotropic Multiaxial linear elastic E, ν, ρ

Full Catalog: Uniaxial Materials (68, in 7 Groups)

① Steel & reinforcement (11) Steel01 · Steel02 · Steel4 · ASDSteel1D · ReinforcingSteel · DoddRestrepo · RambergOsgoodSteel · SteelMPF · UVCUniaxial · SteelFractureDI · DuctileFracture

Commonly used: Steel01, Steel02. Research grade: Steel4 (buckling), UVCUniaxial (Voce-Chaboche cyclic plasticity), SteelFractureDI (ductile fracture).

② Concrete (12) Concrete01 · Concrete02 · Concrete02IS · Concrete04 · GPCConcrete01 · ASDConcrete1D · GMG_CyclicReinforcedConcrete · CreepShrinkageACI209 · TDConcrete · TDConcreteEXP · TDConcreteMC10 · TDConcreteMC10NL

Commonly used: Concrete01/02/04. Special-purpose: TDConcrete family (time-dependent, shrinkage & creep), CreepShrinkageACI209 (ACI 209 shrinkage/creep wrapper), GPCConcrete01 (geopolymer concrete).

③ Standard uniaxial (8) Elastic · ElasticPP · ElasticPPGap · ElasticNoTension · ElasticBilin · ElasticMultiLinear · Hardening · MultiLinear

These 8 are the “simplest backbone” materials—few parameters, hard to get wrong. Prefer them for concept comparisons and load-path verification.

④ General multilinear hysteresis (6) Hysteretic · HystereticSM · IMKBilin · IMKPeakOriented · IMKPinching · SLModel

Hysteretic is the most practical choice for masonry, joints, and bearings—you supply backbone points directly, no constitutive equations to manage. The IMK family (Ibarra-Medina-Krawinkler) models degradation in beam-column joints/plastic hinges.

⑤ Wrapper materials (12) Fatigue · Parallel · Series · TensionOnly · SimpleFracture · InitStrain · InitStress · MinMax · PathIndependent · Damper · Penalty · Multiplier

Wrappers don’t define a constitutive model; they wrap another material and modify its behavior. The two most used: TensionOnly (tension only, no compression—for cables and tension-only braces) and InitStrain (applies initial strain—for prestress). Parallel / Series combine multiple materials in parallel/series (parallel = stiffnesses add, series = flexibilities add).

⑥ Other uniaxial (11) BoucWenInfill · HystereticPoly · HystereticAsym · HystereticSmooth · DowelTypeTimberJoint · CoulombDamper · HertzDamp · JankowskiImpact · ViscoelasticGap · Ratchet · FrictionSpringDamper

Special-purpose: BoucWenInfill (masonry infill walls), DowelTypeTimberJoint (timber dowel connections), CoulombDamper (Coulomb damping), HertzDamp / JankowskiImpact (impact, contact).

⑦ Pile-soil p-y / t-z / q-z (8) PySimple1 · TzSimple1 · QzSimple1 · PyLiq1 · TzLiq1 · QzLiq1 · TzSandCPT · QbSandCPT

Py/Tz/Qz correspond to lateral, shaft friction, and tip resistance respectively. The Liq variants account for liquefaction. The SandCPT variants take parameters directly from CPT tests.

Full Catalog: Multiaxial Materials (23 + supplements)

Elasticity & plasticity (4): ElasticIsotropic · ElasticOrthotropic · J2Plasticity · DruckerPrager

Soil dynamics (7): PressureIndependMultiYield · PressureDependMultiYield · PressureDependMultiYield02 · ManzariDafalias · PM4Sand · PM4Silt · BoundingCamClay

PM4Sand / PM4Silt are the first choice for liquefaction analysis (standard calibration procedures, benchmarkable against CPT/SPT). The PressureDepend family is the classic UCSD model—many parameters, but well supported in the literature.

Multiaxial concrete & steel (5): ASDConcrete3D · ASDPlasticMaterial3D · OrthotropicRAConcrete · SmearedSteelDoubleLayer · J2CyclicBoundingSurface

Wrappers (4): OrthotropicMaterialWrapper · Series3D · Parallel3D · InitStrain (nD version)

Shells & plane (supplement): PlaneStress · PlaneStrain · PlateFiber · PlaneStressUserMaterial · PlateFromPlaneStress · PlateRebar · LayeredShell · FSAM

Layered shells (LayeredShell) are the recommended approach for shear walls: each layer gets one uniaxial material (concrete layers + rebar layers), far cheaper than solid elements, and accuracy is adequate for walls. PlateFromPlaneStress converts a plane-stress material into a plate material and is a prerequisite step for layered shells.

Contact & special (supplement): ContactMaterial2D · ContactMaterial3D · InitialStateAnalysisWrapper · FluidSolidPorousMaterial · AcousticMedium · StressDensity · UVCmultiaxial · UVCplanestress

FluidSolidPorousMaterial is for saturated soil (consolidation, liquefaction); AcousticMedium is for acoustics (Kavvo does not expose acoustics; see document no. 10).

Five Selection Anti-Patterns

1. Using a complex constitutive model for show

PM4Sand + Steel4 + Concrete07 at the concept stage with all default parameters. An uncalibrated complex model is less credible than a calibrated simple one. For concept comparisons use Elastic or Steel01/Concrete02, with traceable parameters.

2. Forcing concrete constitutive models onto masonry

Masonry is anisotropic and jointed; Concrete02 overestimates wall stiffness. Use Hysteretic with a trilinear backbone + an equivalent diagonal strut, or code-specified equivalent stiffness.

3. Using an ordinary truss material for cables

Cables cannot carry compression. ElasticPP with truss elements produces a spurious “negative stiffness” in compression. You must use the TensionOnly wrapper.

4. Faking a bearing with Steel02

An elastomeric bearing’s shear hysteresis is not steel’s Bauschinger effect. Use the ElastomericBearingPlasticity element or Hysteretic with a shear backbone.

5. Using DruckerPrager for liquefaction

DruckerPrager is a monotonic plasticity model; it cannot capture cyclic pore pressure buildup. Liquefaction requires PM4Sand or the PressureDepend family.

Criteria: Four Selection Self-Check Questions

  1. What is the element type? It decides uniaxial vs. multiaxial—this step cannot be wrong
  2. Is there cyclic loading? If so, monotonic models (Steel01, ElasticPP) are out
  3. Does every parameter have a documented source? An untraceable parameter isn’t settled
  4. Did you use the simplest model that answers the question? If Elastic can answer it, don’t use PM4Sand

The calculation report prints a materials table with three columns: “model type / key parameters / parameter source.” Materials with an empty source column are flagged—that’s the first thing reviewers look at.

materialsselectiondecisioncatalogindexbearingsdamperssoil springs