Skip to content

Units & Quantities

units-and-quantitiesApplies to create / edit / troubleshoot~610 tokens

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

In One Sentence

Kavvo defaults to mm-kN-s. Under this system, enter the elastic modulus as 200 (not 200000) and density as 7.85e-12 (not 7850, and not 7.85e-9).

Why These Two Numbers Get Entered Wrong Most Often

Because most OpenSees tutorials online use other unit systems, and density’s value differs by integer multiples between unit systems. Being off by one order of magnitude makes modal frequencies wrong by a factor of 31.6—and nothing raises an error.

Correct Values Under mm-kN-s

Quantity Unit Steel value How it’s derived
Length mm — Base
Force kN — Base
Time s — Base
Stress / elastic modulus kN/mm² (= GPa) 200 200 GPa = 200 kN/mm²
Mass kN·s²/mm (= 10⁶ kg) — F·T²/L
Density kN·s²/mm⁴ 7.85e-12 7850 kg/m³ ÷ 10¹⁵
Gravitational acceleration mm/s² 9810 9.81 m/s²
Unit weight (for self-weight) kN/mm³ 7.70e-8 ρ·g = 77.0 kN/m³

Self-consistency check: 7.85e-12 × 9810 = 7.70e-8, corresponding to 77.0 kN/m³. That’s 2% off the code’s steel unit weight of 78.5 kN/m³ (78.5 comes from taking g = 10). This 2% difference is normal—don’t change g to chase 78.5.

Three Widely Circulated Wrong Values

Error 1: Density entered as 7.85e-9

7.85e-9 is the density under mm-N-s (where the mass unit is 1000 kg). Enter it under mm-kN-s and mass is 1000 times too large, frequencies 31.6 times too small.

Symptom: modal analysis returns a first frequency of 0.8 Hz when a hand calculation says 25 Hz. The model looks perfectly normal, but displacement responses become absurdly large.

Error 2: Density entered as 7850

That’s kg/m³ copied straight in. Mass is 10¹⁵ times too large—dynamic analysis turns quasi-static, or the solver reports a singular matrix.

Symptom: analyze fails to converge, or displacements are on the order of 1e-15.

Error 3: Elastic modulus entered as 200000

200000 is the MPa-system value. Enter it under mm-kN and stiffness is 1000 times too large, displacements 1000 times too small.

Symptom: beam deflection under gravity load is 0.003 mm—it looks like “an extremely stiff structure,” but it’s really wrong units.

Criteria: Three Consistency Checks

After modeling, run these three checks before solving; failing any one means the units are wrong:

  1. Total self-weight = volume × 7.70e-8 (kN). For a 30m×20m×10-story frame, the estimated total weight should be on the order of 10⁴ kN
  2. Sensible range for E: concrete 25–40, steel 200–210, aluminum 70. Off by a factor of 10 means it’s wrong
  3. First natural frequency: conventional multi-story buildings 0.5–3 Hz; a single member 10–100 Hz. Getting 0.01 Hz or 1000 Hz—check density first

Metric–Imperial Mixing

The AISC package defaults to in-kip-s; the GB package defaults to mm-kN-s. When switching code packages, values in the model are not auto-converted—Kavvo cannot know whether the 200 you entered is 200 GPa or 200 ksi.

So when switching packages and existing material data is detected, a confirmation must pop up: “The current material’s E=200 will be interpreted as 200 ksi (≈1379 GPa) under the new unit system (in-kip-s). Convert?”

This is the only scenario where automatically changing values is allowed, and the user must see both numbers—before and after conversion.

Relationship to the AI

When the model generates scripts, units must be declared explicitly on the first line of the script:

# units: mm-kN-s

Without that line, any generated script is treated as suspect. Models readily switch to the N-mm system on their own when “the user mentioned MPa,” then convert only half the numbers—that is more dangerous than not converting at all, because half the numbers look right.

unitsdimensionsdensityelastic modulusself-weight