Material Selection & Full Catalog
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
- What is the element type? It decides uniaxial vs. multiaxial—this step cannot be wrong
- Is there cyclic loading? If so, monotonic models (Steel01, ElasticPP) are out
- Does every parameter have a documented source? An untraceable parameter isn’t settled
- 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.