NIST ITS-90 thermocouple conversion for Python: voltage to temperature and temperature to voltage for all eight letter-designated types (B, E, J, K, N, R, S, T), with cold-junction compensation and Seebeck coefficients. The test suite verifies every one of the 12,026 tabulated points of the NIST reference tables on every run.
Pure standard library, no dependencies, fully typed. A browser version of this engine runs as a free online thermocouple calculator, vendored from this repository on every release.
pip install thermocouple-its90from thermocouple_its90 import TypeK
TypeK.emf(300.0) # 12.209 (mV at 300 C, 0 C reference: the table value)
TypeK.temperature(12.209) # 300.0 (C, ice-bath reference)
TypeK.seebeck(300.0) # 0.0416 (mV per C)
TypeK.range # (-270.0, 1372.0)A thermocouple measures the difference between its junctions, and the reference tables assume the cold junction sits at 0 C. If your meter's terminals are at room temperature, a direct table lookup is wrong:
from thermocouple_its90 import TypeK
# Meter reads 4.096 mV, terminals at 25 C:
TypeK.temperature(4.096) # 100.0 C <- naive lookup, wrong
TypeK.temperature(4.096, reference=25.0) # 124.3 C <- the actual answerAll eight types work the same way:
from thermocouple_its90 import get, letters
letters() # ['B', 'E', 'J', 'K', 'N', 'R', 'S', 'T']
get("s").emf(1400.0) # 14.373 mV
get("t").temperature(-4.648) # -149.98 C (cryogenic ranges included)
- The forward reference functions reproduce all 12,026 one-degree points
of the NIST reference tables within their 0.001 mV print rounding. The
full comparison runs in CI on every push (
tests/test_full_tables.py). - Inversion seeds with the published ITS-90 inverse polynomials and refines by Newton iteration on the exact forward function. Round trips agree to microdegrees instead of the inverse polynomials' 0.02 to 0.06 C error bands.
- Types K, E and T invert over their full cryogenic ranges (to -270 C), below where the published inverse polynomials stop.
- Type B is handled with its physics: its EMF is non-monotonic near room temperature, so inversion below 0.291 mV (about 250 C) is refused with an explanation instead of returning one of two possible answers.
Language models mis-remember thermocouple polynomials. The package ships a Model Context Protocol server so agents call the verified implementation instead:
pip install "thermocouple-its90[mcp]"
claude mcp add thermocouple -- thermocouple-its90-mcpTools: thermocouple_to_temperature, thermocouple_to_emf,
thermocouple_types. All three are annotated read-only and idempotent with
no outside effects, so a host can tell a user what a call will do before it
runs.
The extra needs Python 3.10 or newer and works with either line of the MCP SDK, 1.7 and later or 2.x. CI builds the server against both on every push.
Coefficients were machine-parsed, never hand-typed, from the NIST ITS-90
Thermocouple Database (SRD 60, https://its90.nist.gov/). The database reproduces
NIST Monograph 175 (Burns, Scroger, Strouse, Croarkin, and Guthrie, 1993),
a United States government publication not subject to copyright. The
canonical dataset lives in data/its90.json; _data.py is generated from
it and CI fails if they drift. Code is MIT licensed.
- Live calculator, this engine in the browser, with worked examples and FAQ
- More verified engineering calculators by the same author, including reference-electrode, alloy-composition, diffusion and XRD tools
- lcf-strain-life, the same library-plus-MCP pattern for low-cycle fatigue analysis
If this library is useful in published work, please cite it via the
concept DOI https://doi.org/10.5281/zenodo.22036393, which always resolves to
the latest release (see CITATION.cff). Please also cite the underlying reference: Burns, G. W., Scroger, M. G., Strouse, G. F.,
Croarkin, M. C., & Guthrie, W. F. (1993). Temperature-electromotive force
reference functions and tables for the letter-designated thermocouple types
based on the ITS-90 (NIST Monograph 175). NIST.