How RedBison calculators are built and checked
Updated
RedBison has 331 calculators and converters for engineering, maths, science, finance and health. This page explains where their formulas come from, how each one is built and tested, what you get when you export a calculation, and where the tools stop and professional judgement has to take over. It applies to every calculator on the site; the About page covers the rest of RedBison.
Where the formulas come from
Each calculator implements the equation used in its field, taken from a published source rather than a summary site. When two sources disagree on a value, the higher of these tiers wins, and the choice is noted in the tool’s write-up:
- The defining document. The standard, regulation or specification itself: the BIPM SI Brochure and NIST SP 811 for units and conversion factors, CODATA for physical constants, IETF RFCs and ISO standards for formats, and the tax authority’s own publication (IRS, HMRC, CRA, ATO) for tax rules.
- Consensus codes and standards. The documents engineers are held to: building and loading codes (IBC, ASCE 7), material and design standards (AISC, ACI, ASTM, EN 1993), the electrical code (NFPA 70), ASHRAE for HVAC and ASME for mechanical design. They set the defaults, limits and checks a calculator applies.
- Peer-reviewed research and health bodies. The original paper behind a formula (for example, the Mifflin-St Jeor energy equation) and the guidance of bodies such as the WHO, the CDC and national dietary guidelines for health calculators.
- Reference books. Standard handbooks and textbooks (Roark’s Formulas for Stress and Strain, Shigley’s Mechanical Engineering Design, Machinery’s Handbook, Çengel’s thermodynamics and fluids texts) for derivations, worked examples and how a topic is conventionally taught.
- Official statistics. Government data such as consumer price indices and energy statistics, used as reference values and always named with their release.
Every calculator page lists its references under “Sources and further reading”, with the publisher and a link. Those links are fetched by an automated check before a page ships and again when pages are refreshed, so a moved or retired source is noticed.
How a calculator is built
- Pick the governing equation. The equation, its assumptions and its range of validity are written down first. Where a field uses more than one method, the calculator uses the most widely adopted one and says so; some tools let you choose.
- Write it once, as a tested function. The maths lives in its own module, separate from the page. The page, the tests and RedBison’s AI interface (the MCP server’s run_calculator tool) all call that same function, so they cannot give different answers.
- Handle units explicitly. Engineering calculators convert your inputs to SI units, compute, and convert back for display, using exact factors where the definitions make them exact (1 in = 0.0254 m, standard gravity 9.80665 m/s²).
- Round only for display. Results are computed in double-precision floating point and rounded only when shown. Where an authority rounds in a set way (tax to the pound or the nearest 10 rupees), the calculator rounds the same way and says so.
How results are checked
- Worked examples. Tests compare calculators with worked examples from their sources and with hand calculations. On newer pages, the worked examples printed in the write-up and the guide are pinned in those tests, so the text cannot drift from what the tool computes.
- Edge cases. Zero, negative, very large and boundary inputs, values that should give a known answer, and inputs that must be rejected with a clear message instead of a wrong number.
- Bug fixes start with a failing test. When an error is reported, a test that reproduces it is written before the fix, so it cannot come back.
- Every page renders. An automated check renders every tool and reads its calculation report, so a broken result display is caught before release.
What every calculator shows
A result you cannot check is hard to use in a report. Each calculator is built to the same standard:
- Standard formulas. The equations it uses, in the notation of the field, with the source they come from.
- The working. The calculation for your own inputs, step by step: the equation, the equation with your numbers in, and the result, so you can verify it by hand or show it to a reviewer.
- Charts where the answer is a series. Schedules, curves and comparisons (a loan balance over time, a beam’s deflected shape) are drawn as interactive charts, with the numbers also available as a table.
- CSV and PDF reports. Under each calculator, “Save or share this calculation” exports a CSV for spreadsheets or a PDF report with your inputs, the results, the working, the formulas, any tables and charts, and the standards cited. “Copy link” gives a link that reopens the calculator with the same inputs.
Reports are built in your browser from what the calculator shows. Your inputs are not uploaded to make them.
Keeping figures current
- Dated rule sets. Country-specific tools (tax, stamp duty, pensions) keep each year’s figures as a separate, dated set with its official source and the date it was last checked. A new budget adds a set; old ones stay, so a past date keeps the answer it had. The tool names the rules it used next to the result, and a set past its review date fails the test suite until it is checked.
- Yearly figures. Limits that change every January (contribution limits, tax brackets, wage bases) are re-checked against the official release at the start of each year.
- Regular review. About a tenth of the tools and guides are reviewed each month for new standards, better worked examples and reader reports. A page’s “Updated” date moves only when its content changes.
Limits and appropriate use
- Not a substitute for a licensed professional. Calculations submitted for a permit, a regulatory filing or a structural, electrical or pressure design must be prepared and signed by a qualified engineer using the governing code. RedBison is a fast, transparent check, not the final authority.
- Not for safety-critical design. Do not use these tools as the only calculation for life-safety systems, medical devices, aircraft or anything else that requires validated, certified software.
- Assumptions matter. Most engineering formulas assume something: linear elasticity, small deflections, incompressible flow, steady state. Each tool lists its assumptions; the result is only as good as their fit to your case.
- Money and health. Finance and health calculators inform decisions; they are not financial, tax or medical advice. Check significant decisions with a qualified adviser or clinician.
Reporting an error
If a result, formula, table or example looks wrong, email team@redbison.dev or use the feedback link at the bottom of any page. Include the page link (the “Copy link” button keeps your inputs), what you entered, what you expected and why. Confirmed errors are fixed with a test that reproduces them, and the page’s updated date shows when the fix went live.