Materials library · Open handbook

Not 91 names — how to fill in each one correctly

Other software tells you it 'supports all OpenSees materials'. We do something else: document the ten you'll actually use, one by one — what every parameter means, its unit, and what you'll see if you get it wrong. The parameter tables deliberately omit specific coefficients, because coefficients must come from your project's code edition; hard-coding them would do more harm than good.

  • 68typesUniaxial materials7 groups, for fibre sections and zero-length elements
  • 23typesMultiaxial materialsFor solid and thick-shell elements
  • 10typesLearn these firstCover 80% of routine engineering
  • 4docsHandbook documentsOverview / steel / concrete / selection

Confirm the unit system before typing any number

The handbook uses the mm-kN-s system throughout: length mm, force kN, stress MPa, mass t. In this system E's value is one thousand times the GPa figure (for Q235 enter 206, not 206000, and not 2.06e11). Half of all wrong-parameter cases come from mixed unit systems — especially E and density copied in from elsewhere.

  • Stress (fy, f'c, ft): enter values in MPa
  • Elastic moduli (E, Ec, Ets): enter values in MPa, i.e. GPa × 1000
  • Strains (εc0, εu, epsY): dimensionless decimals, not percentages
  • Density (ρ): on the order of t/mm³ — not kg/m³

Steel and reinforcement

Selection comes down to two questions: is there cyclic loading, and do you need buckling modeled.

Handbook → Steel and reinforcement
  • Steel02Most used

    Menegotto-Pinto steel

    Bilinear backbone with a smooth-transition kinematic hardening hysteresis

    ParameterMeaningUnitIf you get it wrong
    fyYield strengthMPaUse the nominal yield of the steel grade, not a design-reduced value
    E0Initial elastic modulusMPaFor Q235 enter 206; entering 206000 makes the stiffness a thousand times too high
    bStrain-hardening ratio—Hardening modulus ÷ E0, on the order of 0.01. Entering 2000 means you mistook it for a modulus
    R0Initial curvature parameter—Affects only the transition rounding — not a material property; use the default for routine analysis
    cR1 / cR2Curvature degradation coefficients—Same as above; touch them only when fitting test hysteresis loops
    Where it fits
    Steel members and reinforcement under seismic, pushover, or any analysis step with cyclic loading
    Don't use it for
    Don't tune R0 to match capacity or displacement — it does not change strength
    Self-check
    The yield strain fy/E0 should be on the order of 0.001–0.002
  • Steel01

    Bilinear kinematic-hardening steel

    Bilinear backbone, with fat hysteresis loops

    ParameterMeaningUnitIf you get it wrong
    fyYield strengthMPaSame as Steel02
    E0Elastic modulusMPaSame as Steel02
    bStrain-hardening ratio—Same as Steel02; 0 gives elastic–perfectly plastic behavior
    Where it fits
    Monotonic loading (static, gravity, capacity estimates before buckling)
    Don't use it for
    Under cyclic loading it overestimates energy dissipation and underestimates seismic displacement response
    Self-check
    If any analysis step unloads even once, switch to Steel02
  • ReinforcingSteelSpecialized

    Reinforcing steel (with buckling and fatigue)

    Yield plateau + hardening branch, with optional buckling and low-cycle fatigue

    ParameterMeaningUnitIf you get it wrong
    fy / fuYield and ultimate strengthMPaFor HRB400, fu/fy is about 1.35
    E / EshElastic and hardening moduliMPaRebar E is about 200, slightly lower than structural steel
    eshiOnset-of-hardening strain—Sets the length of the yield plateau
    Where it fits
    Members where rebar buckling or low-cycle fatigue matters (columns, shear-wall boundary elements)
    Don't use it for
    For routine beams and columns Steel02 is enough — this model has more parameters and a higher calibration cost
    Self-check
    Without test data, don't enable the buckling branch

Concrete

First separate confined from unconfined, then decide whether the tension branch is needed.

Handbook → Concrete
  • Concrete02Most used

    Concrete with tension softening

    Kent-Scott-Park compression + linear tension softening

    ParameterMeaningUnitIf you get it wrong
    f'cCylinder compressive strengthMPaCylinder only; entering a cube strength directly overestimates by about 25%
    εc0Strain at peak stress—On the order of 0.002
    f'cu / εuResidual strength and ultimate strainMPa / —About 0.0033 for unconfined; compute confined values with a confinement model
    ftTensile strengthMPaLeave it out and the section carries no tension at all — beam deflections run large
    EtsTension-softening modulusMPaDirectly controls post-cracking behavior
    λUnloading stiffness coefficient—For cyclic analyses; no effect on monotonic loading
    Where it fits
    RC beams, slabs, layered-shell shear walls
    Don't use it for
    Don't use it as confined concrete in column cores — both strength and ductility come out underestimated
    Self-check
    The report must state whether f'c came from a cylinder or a cube
  • Concrete01

    Concrete without tension

    Kent-Scott-Park compression, with a zero tension branch

    ParameterMeaningUnitIf you get it wrong
    f'cCylinder compressive strengthMPaSame as above
    εc0Peak strain—Same as above
    f'cu / εuResidual strength and ultimate strainMPa / —Same as above
    Where it fits
    Compression-dominated locations where tension is negligible: column cover concrete, bearing blocks
    Don't use it for
    In flexural members, post-cracking stiffness collapses abruptly
    Self-check
    If cracks or deflections matter to you, switch to Concrete02
  • Concrete04Confined core

    Popovics confined concrete

    Smooth Popovics curve; strength and ductility rise with confinement

    ParameterMeaningUnitIf you get it wrong
    fcConfined compressive strengthMPaMust be computed from stirrups with a confinement model such as Mander — not just f'c
    ecPeak strain—The confined peak strain likewise must be computed
    ecuUltimate strain—Confined concrete can go far beyond 0.0033
    EcElastic modulusMPaOn the order of 4700√f'c
    ft / etTensile strength and strainMPa / —May be zeroed
    Where it fits
    Column core concrete, spirally confined columns, tube-confined concrete
    Don't use it for
    Don't use it in unconfined zones — ductility comes out overestimated
    Self-check
    The confined strength and peak strain must be reproducible from the stirrup parameters

General and multiaxial

When unsure, start with the simplest model and add complexity step by step.

Handbook → General and multiaxial
  • ElasticStarting point

    Linear elastic

    Purely linear elastic, no yielding

    ParameterMeaningUnitIf you get it wrong
    EElastic modulusMPaThe only required parameter
    Where it fits
    Load-path verification, scheme comparison, modal analysis (when yielding doesn't matter)
    Don't use it for
    Never draw capacity conclusions from linear-elastic results
    Self-check
    If you only need periods and deformation shapes, this is the right model
  • ElasticPP

    Elastic–perfectly plastic

    Elastic branch + no-hardening plateau

    ParameterMeaningUnitIf you get it wrong
    EElastic modulusMPaSame as Elastic
    epsYp / epsYpNegPositive and negative yield strains—Yield is defined by strain, not stress
    Where it fits
    Tension-only cables (with tension-only constraint), simple energy-dissipating devices, preliminary pushover
    Don't use it for
    In statically indeterminate structures, no internal force redistribution develops (capacity caps without hardening)
    Self-check
    Yield strain × E should equal your intended yield stress
  • Hardening

    Isotropic + kinematic hardening

    Bilinear, with hardening split into isotropic and kinematic parts

    ParameterMeaningUnitIf you get it wrong
    EElastic modulusMPaSame as above
    sigYYield stressMPaDefined by stress — more intuitive than ElasticPP
    HisoIsotropic hardening modulusMPaControls yield-surface expansion (weak Bauschinger effect)
    HkinKinematic hardening modulusMPaControls yield-surface translation (strong Bauschinger effect)
    Where it fits
    Steels and mild-steel dampers that need separate isotropic and kinematic control
    Don't use it for
    Setting both to zero equals elastic–perfectly plastic — just use ElasticPP instead
    Self-check
    Hiso + Hkin should be on the same order as E×b
  • HystereticUniversal fallback

    Multilinear hysteretic

    Three-point backbone in each direction + pinching + damage

    ParameterMeaningUnitIf you get it wrong
    s1p,e1p … s3p,e3pPositive-direction three points (stress, strain)MPa / —Trilinear backbone, given point by point
    s1n,e1n … s3n,e3nNegative-direction three pointsMPa / —Can be zeroed for asymmetric members (e.g. tension-only)
    pinchX / pinchYDegree of pinching—1 means no pinching; smaller values pinch more
    damage1 / damage2Strength and stiffness damage—Simulates cumulative-damage degradation
    Where it fits
    Masonry equivalent struts, bearings, members without a dedicated model (calibrated from test backbone curves)
    Don't use it for
    Backbone points must come from tests or codes — never drawn by feel
    Self-check
    The three backbone points must increase monotonically (both stress and strain)
  • ElasticIsotropicMultiaxial

    Multiaxial linear elastic

    Isotropic linear elasticity (3D stress state)

    ParameterMeaningUnitIf you get it wrong
    EElastic modulusMPaSame as Elastic
    vPoisson's ratio—0.2 for concrete, 0.3 for steel
    rhoDensityt/mm³Required for dynamic analysis; on the order of 2.4e-9
    Where it fits
    Linear-elastic and modal analysis of solid and thick-shell elements
    Don't use it for
    Never use multiaxial materials on uniaxial elements (beams, trusses) — wrong layer
    Self-check
    Element type determines the layer: fibre sections take uniaxial materials, solids take multiaxial

Where parameters come from: three sources, ranked

The same f'c can take three different values, and results can differ by 30%. The handbook's order is strict:

  1. 1

    The code edition specified by the project

    Design values, partial factors and material strengths follow the clauses of the code edition adopted by the project. State the edition in the report.

  2. 2

    Test data

    If material tests exist, use the measured values and attach the test report number to the report.

  3. 3

    Software defaults

    Only for early scheme comparison, before materials are fixed. Defaults are not code values and never belong in a formal report.

These three rules are not our invention — they are standard practice in structural design. We state them openly because many software products bury defaults in dialogs, leaving users to assume those values are code values.

The complete list

All 91 listed, nothing hidden. Items marked as commonly used are the ones routine engineering actually touches; the rest are research-grade or specialized models.

  • Steel and reinforcement

    11 types

    Steel01 · Steel02 · Steel4 · ASDSteel1D · ReinforcingSteel · DoddRestrepo · RambergOsgoodSteel · SteelMPF · UVCUniaxial · SteelFractureDI · DuctileFracture

  • Concrete

    12 types

    Concrete01 · Concrete02 · Concrete02IS · Concrete04 · GPCConcrete01 · ASDConcrete1D · GMG_CyclicReinforcedConcrete · CreepShrinkageACI209 · TDConcrete series

  • Standard uniaxial

    8 types

    Elastic · ElasticPP · ElasticPPGap · ElasticNoTension · ElasticBilin · ElasticMultiLinear · Hardening · MultiLinear

  • Hysteresis and pinching

    6 types

    Hysteretic · Pinching4 · BoucWen · SelfCentering · MinMax · LimitState

  • Viscous and damping

    7 types

    Viscous · ViscousDamper · BilinearOilDamper · Maxwell · Kelvin · Fabric · others

  • Friction and soil springs

    12 types

    PySimple1 · TzSimple1 · QzSimple1 · PyLiq1 · TzLiq1 · Hardening · friction model family

  • Other uniaxial

    12 types

    InitStrainMaterial · InitStressMaterial · Parallel · Series · Aggregator · wrapper family

  • Multiaxial materials

    23 types

    ElasticIsotropic · J2Plasticity · DruckerPrager · DruckerPragerCap · CamClay · PressureDependMultiYield · PressureIndependMultiYield · PM4Sand · PM4Silt · others

Counts and grouping follow the handbook (materials-selection.md). Material type names are generic identifiers; parameter order follows the official OpenSees documentation — we don't reorder parameters, and we don't pretend to guess them for you.