AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

uncertainty-and-units

Tracks physical units and propagates measurement uncertainty in scientific calculations using pint and uncertainties. Use for unit conversion and dimensional checking, GUM uncertainty budgets, Type A and Type B evaluation, coverage factors and expanded uncertainty, Monte Carlo propagation, significant-figure and plus-minus reporting, error propagation through curve fits, CODATA constants, auditing Python code for stripped units or broken uncertainty propagation, and order-of-magnitude plausibility checks using dimensionless groups (Reynolds, Peclet, Damkohler, Knudsen, Biot, Womersley), characteristic scales such as diffusion time or Debye length, and observed magnitude ranges. Trigger on "is this number physically reasonable", "sanity check these units", "what regime is this flow in", or a result that looks off by orders of magnitude.

Original source
K-Dense-AI
License
MIT
Pinned revision
5f2bc0341354fd5590aef76a533ada1e1e5b4e62

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read k-dense-ai--uncertainty-and-units at revision 5f2bc0341354fd5590aef76a533ada1e1e5b4e62, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 8

references/plausibility-scales.md

Plausibility: dimensionless groups, characteristic scales, and magnitude bands

Dimensional analysis proves a calculation is consistent. It cannot prove the answer is possible. A cell 2 m across, a Reynolds number of 4×10⁷ in a capillary, and a diffusion time of 300 years across a lipid bilayer are all dimensionally impeccable, and a unit-checking library will pass every one of them.

The three checks below provide screens for that gap, conditional on the model. scripts/check_plausibility.py runs all of them and verifies dimensional consistency of each formula before reporting a number.


1. Choose the characteristic length first

The single most common error in this whole area is not an arithmetic slip — it is using the wrong length. The dimensionless groups are only meaningful with the length the correlation was fitted against.

| Geometry | Characteristic length | | --- | --- | | Flow in a circular pipe | inside diameter, not radius | | Flow in a non-circular duct | hydraulic diameter 4A/P | | External flow over a plate | distance from the leading edge | | Flow past a sphere or cylinder | diameter | | Conduction in an irregular body (Biot) | volume / surface area | | Packed bed | particle diameter | | Open channel | state convention: A/P or hydraulic diameter 4A/P, with matching thresholds |

Using radius where the correlation wants diameter puts every threshold out by a factor of two, which is exactly the size of error that survives review.

2. Dimensionless groups and what they gate

These are ratios of physical scales. Listed thresholds are context-dependent heuristics, not universal points at which an assumption automatically becomes false.

| Group | Definition | Threshold | What stops being true past it | | --- | --- | --- | --- | | Reynolds Re | ρvL/μ | 2300 / 4000 (pipe) | laminar solutions; above 4000 you need a turbulence model | | Péclet Pe | vL/D | ≈ 1 | relative importance of advection and diffusion at the chosen scale | | Damköhler Da_I | kL/v | 0.1 / 10 | small Da means slow reaction during transit; large Da permits high ideal conversion | | Knudsen Kn | λ/L | 0.01 | the no-slip boundary condition, then the continuum assumption itself | | Mach Ma | v/c | 0.3 | incompressibility, at about 5% density change | | Womersley Wo | R√(ωρ/μ) | 1 / 10 | quasi-steady parabolic approximation; large Wo gives a flatter oscillatory core | | Capillary Ca | μv/σ | ≈ 10⁻³ | viscous/capillary balance; 1e-3 is illustrative, not a universal onset | | Weber We | ρv²L/σ | ≈ 12 | possible bag breakup for low-Oh droplets; use ambient density and relative speed | | Bond Bo | Δρ g L²/σ | 1 | surface tension holding a drop against gravity | | Stokes Stk | ρ_p d² v / (18 μ L) | 0.1 | inertial following; also check buoyancy, size and Stokes-drag validity | | Biot Bi | hL/k | 0.1 | lumped-capacitance (uniform internal temperature) | | Fourier Fo | αt/L² | 0.05 / 1 | internal diffusion time; equilibrium also depends on Bi and boundary conditions | | Schmidt Sc | μ/(ρD) | — | ≈ 1 for gases, ≈ 10³ for small molecules in water | | Deborah De | t_relax/t_obs | 1 | whether the material is a liquid or a solid on your timescale |

Womersley takes angular frequency. Pass 2πf, not f. A resting human heart at 1.2 Hz gives ω ≈ 7.5 rad/s, and in the aorta Wo ≈ 20 — firmly plug-like, which is why Poiseuille's law is the wrong model for arterial flow while microvascular rheology, discrete cells and vessel compliance can still invalidate a Newtonian rigid-tube capillary model even at low Wo.

The Reynolds thresholds are pipe-flow values. Transition over a flat plate is around Re ≈ 5×10⁵; sphere wakes and boundary layers have different geometry-specific transitions. The tool reports the pipe classification and says so.

3. Characteristic scales

| Scale | Formula | Sanity anchor | | --- | --- | --- | | Diffusion time | L²/D | 10 µm at 10⁻⁹ m²/s → 0.1 s | | Thermal diffusion time | L²/α | same form, thermal diffusivity | | Thermal energy | k_B T | 4.14×10⁻²¹ J at 300 K | | Molar thermal energy | RT | 2.49 kJ/mol at 300 K | | Stokes settling velocity | Δρ g d²/(18μ) | 1 µm bead, Δρ = 1000 kg/m³, μ = 1 mPa·s → 0.545 µm/s | | Mean free path (gas) | k_BT/(√2 π d² p) | air at 1 atm → ≈ 68 nm | | Debye length | √(ε₀ε_r k_B T / (2 N_A e² I)) | 100 mM ionic strength in water at 25 °C → 0.96 nm | | Capillary length | √(σ/(Δρg)) | water → 2.7 mm |

L² gives a characteristic diffusion scaling, not a complete transport model. Ten micrometres takes 0.1 s; one millimetre takes 1000 s; one centimetre takes 10⁵ s ≈ 28 hours. These values assume D = 10⁻⁹ m²/s. Geometry, dimensionality, binding, membrane partitioning and reaction change actual first-passage/equilibration times. The scale alone cannot infer a biological size limit or tissue viability.

Stokes settling is valid only while the particle Reynolds number stays below ≈ 0.1. Compute the settling velocity, then feed it back into the reynolds group with the particle diameter as the length. If Re_p > 0.1, creeping-flow drag needs review, including finite-Re corrections, walls and shape.

4. Magnitude bands

These are illustrative screening bands, not validated reference intervals or precise ranges extracted from each cited textbook. Their endpoints are curated choices. Verify the relevant organism, phase, temperature, pressure, composition and definition before interpreting a flag. Historical textbook sources below are retained as background and were not all independently reread in this refresh. A value outside one is worth a second look, not automatically wrong — the tool reports questionable inside one decade and implausible beyond it.

| Band | Range | Source | | --- | --- | --- | | Bacterial cell diameter | 0.2–10 µm | Milo & Phillips, Cell Biology by the Numbers, ch. 1 | | Eukaryotic cell diameter | 5–100 µm | Milo & Phillips, ch. 1 | | Cell membrane thickness | 3–5 nm | Alberts et al., MBoC 7th ed., ch. 10 | | DNA base-pair rise | 0.32–0.36 nm | Bloomfield et al., Nucleic Acids | | Ribosome diameter | 20–30 nm | Milo & Phillips, ch. 1 | | Protein molar mass | 5–1000 kg/mol (numerically comparable to kDa molecular mass) | Milo & Phillips, ch. 1 | | Human capillary diameter | 5–10 µm | Guyton & Hall, 14th ed., ch. 16 | | Mammalian body temperature | 306–315 K | Guyton & Hall, ch. 74 | | Resting heart rate | 0.7–3 Hz | Guyton & Hall, ch. 9 | | Blood plasma osmolarity | 275–300 mol/m³ | Guyton & Hall, ch. 25 | | Small-molecule diffusivity in water | 3×10⁻¹⁰–3×10⁻⁹ m²/s | Cussler, Diffusion 3rd ed., app. A | | Protein diffusivity in water | 10⁻¹¹–1.5×10⁻¹⁰ m²/s | Cussler, app. A | | Dynamic viscosity of water | 0.5–1.5 mPa·s | IAPWS R12-08 | | Surface tension of water | 0.06–0.08 N/m | IAPWS R1-76 | | Speed of sound in water | 1400–1560 m/s | Del Grosso & Mader, JASA 52:1442 (1972) | | Speed of sound in air | 320–350 m/s | Cramer, JASA 93:2510 (1993) | | Sea-level atmospheric pressure | 95–105 kPa | ISO 2533 | | Earth surface gravity | 9.76–9.84 m/s² | WGS 84 normal gravity | | Visible wavelength | 380–750 nm | CIE S 017:2020 | | Non-covalent bond energy | 1–40 kJ/mol | Israelachvili 3rd ed., ch. 2 | | Covalent bond energy | 150–1000 kJ/mol | Atkins & de Paula 12th ed. | | Magnitude of cellular ATP hydrolysis free energy | 40–60 kJ/mol | Milo & Phillips, ch. 4 |

Compare binding energies against RT, not against zero. At 300 K, RT is 2.5 kJ/mol. A 1 kJ/mol free-energy difference still changes equilibrium probabilities by a factor of about exp(1/RT) = 1.5; it is not indistinguishable from noise. Binding standard states, sign, concentrations and cooperativity matter.

5. The three errors this catches

A quantity of the wrong kind. Kinematic viscosity (m²/s) where the formula needs dynamic (Pa·s) is the classic. Both are called "viscosity", both are tabulated for water, and they differ by a factor of ρ ≈ 1000. The dimensionality check refuses it before any number is computed:

error: viscosity must have dimensionality [mass] / ([length] * [time]),
       but m²/s is [length] ** 2 / [time]

A unit prefix slip. Micro for milli is three decades. The magnitude bands catch it whenever the quantity is one the table knows.

An assumption used outside its regime. Applying Poiseuille's law at Wo = 20, the lumped-capacitance model at Bi = 5, or Stokes drag at Re_p = 30 all produce a number. The group warns that the model assumptions need review; it does not establish the error in the predicted number.

6. Caveats

  • The thresholds are conventions with soft edges, not physical constants. Re = 2400 in a very smooth pipe can stay laminar; Re = 2000 with a disturbed inlet may not.
  • Every group assumes the geometry its correlation was fitted for. Check §1 before trusting a classification.
  • The bands describe typical observed values, not physical limits. Extremophiles, engineered materials, and pathological states legitimately sit outside them — which is why the tool warns rather than refuses.
  • A plausible verdict means nothing contradicted the tables. It is not a correctness proof, and it says nothing about whether the measurement was any good — for that, see references/gum-methodology.md.

Sources

Checked 2026-10-01:

  • White, Fluid Mechanics, 8th ed. — Reynolds, Mach, pipe-flow transition.
  • Deen, Analysis of Transport Phenomena, 2nd ed. — Péclet, Schmidt, boundary layers.
  • Incropera et al., Fundamentals of Heat and Mass Transfer — Biot, Fourier.
  • Bruus, Theoretical Microfluidics — capillary number, low-Reynolds flow.
  • Berg, Random Walks in Biology — diffusion times, the L² scaling.
  • Phillips et al., Physical Biology of the Cell, 2nd ed. — k_BT as the biological energy scale.
  • Milo & Phillips, Cell Biology by the Numbers — biological magnitude bands; bionumbers.hms.harvard.edu.
  • Israelachvili, Intermolecular and Surface Forces, 3rd ed. — Debye length, bond energies.
  • Cussler, Diffusion, 3rd ed. — diffusivity tables.
  • CODATA internationally recommended values — reached through scipy.constants, never typed as literals.

Current primary checks (2026-10-01):

protein_molar_mass expects mass/amount (kg/mol). A bare kDa is molecular mass; convert with N_A explicitly. The ATP band expects a positive magnitude; signed hydrolysis delta G is usually negative. Neither physiological bands nor exit statuses are clinical reference limits. The helper's overall verdict concerns only requested bands, not the validity of computed groups/scales. It uses nominal constants and standard gravity, without propagating their uncertainties.