SPB Git

Repository Public MIT

generate_reference.py 27.9 KB 524 lines python

1#!/usr/bin/env python32# ORIX Calc3# File: Packages/ORIXUnits/Reference/generate_reference.py4# Description: Independent reference for the unit catalog, computed with exact fractions from the cited definitions.5#6# Author: Simon-Pierre Boucher7# Contact: contact@spboucher.ai8"""9Builds the table of known conversions used by the ORIXUnits test suite.1011Every factor below is derived here, with `fractions.Fraction`, from the primary definitions (BIPM SI12Brochure 9th ed., NIST SP 811 Appendix B, IAU 2012/2015 resolutions, IEC 80000-13, CODATA 2022,13Canada Weights and Measures Act). Nothing is read from the Swift sources: the only thing shared with14the Swift catalog is the unit identifier. The derived values are also asserted against the rounded15values printed in NIST SP 811 Appendix B, as a guard against a wrong derivation.1617Outputs (run from anywhere: `python3 Reference/generate_reference.py`):18  Reference/reference_conversions.tsv                 value, from, to, expected, exact|rounded19  Reference/reference_rates.tsv                       rate-convention closed forms (50 digits)20  Tests/ORIXUnitsTests/ReferenceData.swift            the same tables embedded for the tests21"""22from decimal import Decimal, getcontext, ROUND_HALF_EVEN23from fractions import Fraction as F24from pathlib import Path2526SIG = 34  # significant digits kept for non-terminating expectations2728# --------------------------------------------------------------------------- primary definitions29inch = F("0.0254")                 # international inch, 1959 agreement (NIST SP 811 B.6)30foot = 12 * inch31yard = 3 * foot32mile = 5280 * foot33lb = F("0.45359237")               # international avoirdupois pound, 195934g0 = F("9.80665")                  # standard gravity, 3rd CGPM 190135lbf = lb * g036kgf = g037nmi = F(1852)                      # international nautical mile, 192938gal_us = 231 * inch**3             # US liquid gallon39gal_imp = F("4.54609") / 1000      # imperial gallon, UK W&M Act 1985 / Canada W&M Act Sch. II40litre = F(1, 1000)41cal_th = F("4.184")42cal_it = F("4.1868")43btu = lb * cal_it * 1000 * F(5, 9)  # 1 lb of water by 1 degF with c = 1 cal_IT/(g.K)44atm = F(101325)45mmHg = F("13595.1") * g0 / 1000    # conventional mercury density 13 595.1 kg/m346c = F(299792458)                   # SI 201947e = F("1.602176634e-19")           # SI 201948day = F(86400)49julian_year = F("365.25") * day50gregorian_year = F("365.2425") * day51au = F(149597870700)               # IAU 2012 B252PI = F("3.14159265358979323846264338327950288419716939937510582097494459")53french_foot = F("12.789") * inch   # Canada W&M Act, Schedule III54u_codata = F("1.66053906892e-27")  # CODATA 202255mach_isa = F("340.294")            # ISO 2533 / ICAO Doc 7488, sea level 15 degC5657# Guards against the values printed in NIST SP 811 Appendix B (7 significant digits) and other58# published exact values.59def close(x, text, rel=F(1, 10**6)):60    ref = F(text)61    assert abs(F(x) - ref) <= abs(ref) * rel, (float(x), text)6263assert mile == F("1609.344") and yard == F("0.9144") and foot == F("0.3048")64assert gal_us == F("0.003785411784")65assert lbf == F("4.4482216152605")66assert btu == F("1055.05585262")67assert mmHg == F("133.322387415")68assert c * julian_year == 946073047258080069close(lbf / inch**2, "6894.757")            # psi70close(lbf / foot, "14.59390")               # slug71close(550 * foot * lbf, "745.6999")         # hp72assert 550 * foot * lbf == F("745.69987158227022")73close(75 * kgf, "735.4988")                 # metric hp74close(btu / 3600, "0.2930711")              # Btu/h75close(12000 * btu / 3600, "3516.853")       # ton of refrigeration76close(foot * lbf, "1.355818")               # ft.lbf77close(lb * foot, "0.1382550")               # poundal78close(atm / 760, "133.3224")                # torr79close(mmHg * F("25.4"), "3386.389")         # inHg80close(lb / foot**3, "16.01846")             # lb/ft381close(lb / gal_us, "119.8264")              # lb/gal82close(lb / 7000, "6.479891e-5")             # grain83close(480 * lb / 7000, "3.110348e-2")       # troy ounce84close(43560 * foot**2, "4046.856")          # acre (international foot: 4046.8564224)85assert 43560 * foot**2 == F("4046.8564224")86close(42 * gal_us, "0.1589873")             # barrel87close(gal_imp / 160, "2.841306e-5")         # imperial fl oz88close(gal_us / 128, "2.957353e-5")          # US fl oz89close(1 / foot**2, "10.76391")              # foot-candle in lux90close(au * 648000 / PI, "3.085677581491367e16", F(1, 10**15))  # parsec (IAU 2015 B2)91close(F(1200, 3937), "0.3048006")           # US survey foot92close(180 * french_foot, "58.471308", F(0))9394# --------------------------------------------------------------------------- catalog (id -> model)95U = {}        # id -> ("lin", factor) | ("aff", scale, offset) | ("rec", constant)96REF = {}      # category -> reference key97IRR = set()   # ids whose factor involves pi9899def cat(name, ref, units):100    REF[name] = ref101    for key, model in units.items():102        uid = f"{name}.{key}"103        assert uid not in U, uid104        U[uid] = model if isinstance(model, tuple) else ("lin", F(model))105106P = {"f": -15, "p": -12, "n": -9, "u": -6, "m": -3, "c": -2, "d": -1, "": 0, "da": 1, "h": 2, "k": 3,107     "M": 6, "G": 9, "T": 12, "P": 15, "E": 18, "Z": 21, "Y": 24}108109def si(symbol, prefixes, scale=F(1)):110    return {p + symbol: scale * F(10) ** P[p] for p in prefixes}111112cat("length", "m", {113    **si("m", ["f", "p", "n", "u", "m", "c", "d", "", "k", "M"]),114    "angstrom": F(1, 10**10), "in": inch, "ft": foot, "yd": yard, "mi": mile, "nmi": nmi,115    "mil": inch / 1000, "hand": 4 * inch, "link": F(66, 100) * foot, "rod": F(33, 2) * foot,116    "chain": 66 * foot, "furlong": mile / 8, "fathom": 2 * yard, "league": 3 * mile,117    "ftUS": F(1200, 3937), "arpent": 180 * french_foot, "au": au, "ly": c * julian_year,118    "pc": au * 648000 / PI,119})120IRR.add("length.pc")121122cat("area", "m2", {123    "mm2": F(1, 10**6), "cm2": F(1, 10**4), "m2": 1, "km2": 10**6, "a": 100, "ha": 10**4,124    "in2": inch**2, "ft2": foot**2, "yd2": yard**2, "mi2": mile**2, "acre": mile**2 / 640,125    "arpent": 32400 * french_foot**2,126})127128cat("volume", "m3", {129    "m3": 1, "cm3": F(1, 10**6), "mm3": F(1, 10**9),130    **si("L", ["u", "m", "c", "d", "", "h"], litre),131    "in3": inch**3, "ft3": foot**3, "yd3": yard**3,132    "gal_us": gal_us, "qt_us": gal_us / 4, "pt_us": gal_us / 8, "cup_us": gal_us / 16,133    "floz_us": gal_us / 128, "tbsp_us": gal_us / 128 / 2, "tsp_us": gal_us / 128 / 6,134    "gal_imp": gal_imp, "qt_imp": gal_imp / 4, "pt_imp": gal_imp / 8, "floz_imp": gal_imp / 160,135    "bbl": 42 * gal_us, "cup_metric": 250 * litre / 1000, "tbsp_metric": 15 * litre / 1000,136    "tsp_metric": 5 * litre / 1000,137})138139cat("mass", "kg", {140    **si("g", ["n", "u", "m", "", "k"], F(1, 1000)),141    "t": 1000, "lb": lb, "oz": lb / 16, "st": 14 * lb, "ton_us": 2000 * lb, "ton_uk": 2240 * lb,142    "gr": lb / 7000, "ozt": 480 * lb / 7000, "ct": F(2, 10**4), "slug": lbf / foot, "u": u_codata,143})144145K0 = F("273.15")146cat("temperature", "K", {147    "K": ("aff", F(1), F(0)), "degC": ("aff", F(1), K0),148    "degF": ("aff", F(5, 9), F("459.67")), "degR": ("aff", F(5, 9), F(0)),149})150151cat("speed", "m_s", {152    "m_s": 1, "km_h": F(1000, 3600), "km_s": 1000, "mph": mile / 3600, "kn": nmi / 3600, "ft_s": foot,153    "mach": mach_isa, "c": c,154})155156cat("acceleration", "m_s2", {157    "m_s2": 1, "g0": g0, "ft_s2": foot, "in_s2": inch, "Gal": F(1, 100), "mGal": F(1, 10**5),158})159160cat("pressure", "Pa", {161    **si("Pa", ["", "h", "k", "M", "G"]),162    "bar": 10**5, "mbar": 100, "atm": atm, "at": kgf / F(1, 10**4), "psi": lbf / inch**2,163    "ksi": 1000 * lbf / inch**2, "Torr": atm / 760, "mmHg": mmHg, "inHg": mmHg * F("25.4"),164    "cmH2O": 1000 * g0 * F(1, 100), "inH2O": 1000 * g0 * inch,165})166167cat("energy", "J", {168    **si("J", ["m", "", "k", "M", "G"]),169    "Wh": 3600, "kWh": 3600 * 1000, "MWh": 3600 * 10**6, "cal": cal_th, "kcal": 1000 * cal_th,170    "cal_IT": cal_it, "eV": e, "keV": e * 10**3, "MeV": e * 10**6, "GeV": e * 10**9, "BTU": btu,171    "therm_us": F("1.054804e8"), "therm_ec": 10**5 * btu, "ftlbf": foot * lbf, "erg": F(1, 10**7),172    "tTNT": F("4.184e9"),173})174175cat("power", "W", {176    **si("W", ["u", "m", "", "k", "M", "G"]),177    "hp": 550 * foot * lbf, "hp_metric": 75 * kgf, "hp_electric": 746, "BTU_h": btu / 3600,178    "TR": 12000 * btu / 3600, "ftlbf_s": foot * lbf,179})180181cat("force", "N", {182    **si("N", ["m", "", "k", "M"]),183    "dyn": F(1, 10**5), "kgf": kgf, "lbf": lbf, "ozf": lbf / 16, "kip": 1000 * lbf, "pdl": lb * foot,184})185186cat("time", "s", {187    **si("s", ["p", "n", "u", "m", ""]),188    "min": 60, "h": 3600, "d": day, "wk": 7 * day, "fortnight": 14 * day, "mo": gregorian_year / 12,189    "y365": 365 * day, "a_julian": julian_year, "a_gregorian": gregorian_year,190    "a_tropical": F("365.24219") * day, "decade": 10 * gregorian_year, "century": 100 * gregorian_year,191})192193cat("angle", "deg", {194    "deg": 1, "rad": 180 / PI, "mrad": 180 / PI / 1000, "gon": F(360, 400), "arcmin": F(1, 60),195    "arcsec": F(1, 3600), "turn": 360,196})197IRR.update({"angle.rad", "angle.mrad"})198199DEC = {"k": 3, "M": 6, "G": 9, "T": 12, "P": 15, "E": 18, "Z": 21, "Y": 24}200BIN = {"Ki": 10, "Mi": 20, "Gi": 30, "Ti": 40, "Pi": 50, "Ei": 60, "Zi": 70, "Yi": 80}201cat("dataStorage", "bit", {202    "bit": 1, "nibble": 4, "B": 8,203    **{p + "B": 8 * F(10) ** x for p, x in DEC.items()},204    **{p + "B": 8 * F(2) ** x for p, x in BIN.items()},205    **{p + "bit": F(10) ** DEC[p] for p in ["k", "M", "G", "T"]},206    **{p + "bit": F(2) ** BIN[p] for p in ["Ki", "Mi", "Gi"]},207})208cat("dataRate", "bit_s", {209    "bit_s": 1, "B_s": 8,210    **{p + "bit_s": F(10) ** DEC[p] for p in ["k", "M", "G", "T"]},211    **{p + "bit_s": F(2) ** BIN[p] for p in ["Ki", "Mi", "Gi"]},212    **{p + "B_s": 8 * F(10) ** DEC[p] for p in ["k", "M", "G", "T"]},213    **{p + "B_s": 8 * F(2) ** BIN[p] for p in ["Ki", "Mi", "Gi", "Ti"]},214})215216km = F(1000)217mpg_us = (mile / km) / (gal_us / litre)   # km per litre218cat("fuelEconomy", "km_L", {219    "km_L": 1, "L_100km": ("rec", F(100)), "mpg_us": mpg_us, "mpg_imp": (mile / km) / (gal_imp / litre),220    "mi_L": mile / km, "gal_100mi_us": ("rec", 100 * mpg_us),221})222223cat("frequency", "Hz", {224    **si("Hz", ["m", "", "k", "M", "G", "T"]), "rpm": F(1, 60), "rad_s": 1 / (2 * PI),225})226IRR.add("frequency.rad_s")227228cat("torque", "Nm", {229    "Nm": 1, "kNm": 1000, "kgfm": kgf, "lbfft": lbf * foot, "lbfin": lbf * inch, "ozfin": lbf / 16 * inch,230})231232cat("density", "kg_m3", {233    "kg_m3": 1, "g_cm3": F(1, 1000) / F(1, 10**6), "g_mL": F(1, 1000) / (litre / 1000),234    "kg_L": 1 / litre, "g_L": F(1, 1000) / litre, "lb_ft3": lb / foot**3, "lb_in3": lb / inch**3,235    "lb_gal_us": lb / gal_us,236})237238cat("flowRate", "m3_s", {239    "m3_s": 1, "m3_min": F(1, 60), "m3_h": F(1, 3600), "L_s": litre, "L_min": litre / 60,240    "L_h": litre / 3600, "gal_min_us": gal_us / 60, "ft3_min": foot**3 / 60, "ft3_s": foot**3,241})242243cat("electricCharge", "C", {**si("C", ["u", "m", "", "k"]), "mAh": F("0.001") * 3600, "Ah": 3600, "e": e})244cat("voltage", "V", si("V", ["u", "m", "", "k", "M"]))245cat("electricCurrent", "A", si("A", ["u", "m", "", "k"]))246cat("resistance", "ohm", si("ohm", ["m", "", "k", "M", "G"]))247cat("capacitance", "F", si("F", ["p", "n", "u", "m", ""]))248cat("inductance", "H", si("H", ["n", "u", "m", ""]))249250cat("dynamicViscosity", "Pas", {"Pas": 1, "mPas": F(1, 1000), "P": F(1, 10), "cP": F(1, 1000)})251cat("kinematicViscosity", "m2_s", {252    "m2_s": 1, "mm2_s": F(1, 10**6), "St": F(1, 10**4), "cSt": F(1, 10**6), "ft2_s": foot**2,253})254cat("illuminance", "lx", {"lx": 1, "fc": 1 / foot**2, "ph": 10**4})255Ci = F("3.7e10")256cat("radioactivity", "Bq", {**si("Bq", ["", "k", "M", "G"]), "Ci": Ci, "mCi": Ci / 1000, "uCi": Ci / 10**6})257cat("absorbedDose", "Gy", {**si("Gy", ["u", "m", "c", ""]), "rad": F(1, 100)})258cat("doseEquivalent", "Sv", {**si("Sv", ["u", "m", ""]), "rem": F(1, 100), "mrem": F(1, 10**5)})259cat("typography", "m", {260    "pt": inch / 72, "pc": inch / 6, "px": inch / 96, "in": inch, "mm": F(1, 1000), "cm": F(1, 100), "m": 1,261})262263# --------------------------------------------------------------------------- conversion264def to_ref(x, model):265    kind = model[0]266    if kind == "lin":267        return x * model[1]268    if kind == "aff":269        return (x + model[2]) * model[1]270    return model[1] / x271272def from_ref(r, model):273    kind = model[0]274    if kind == "lin":275        return r / model[1]276    if kind == "aff":277        return r / model[1] - model[2]278    return model[1] / r279280def convert(x, a, b):281    assert a.split(".")[0] == b.split(".")[0], (a, b)282    return from_ref(to_ref(F(x), U[a]), U[b])283284def render(q):285    """Exact decimal string when it terminates within SIG digits, else rounded to SIG digits."""286    q = F(q)287    den = q.denominator288    for p in (2, 5):289        while den % p == 0:290            den //= p291    getcontext().prec = 200292    if den == 1:293        d = Decimal(q.numerator) / Decimal(q.denominator)294        if len(d.as_tuple().digits) <= SIG:295            return format(d.normalize(), "f"), "exact"296    getcontext().prec = SIG297    getcontext().rounding = ROUND_HALF_EVEN298    d = Decimal(q.numerator) / Decimal(q.denominator)299    return format(d, "f"), "rounded"300301rows = []302def add(x, a, b):303    text, kind = render(convert(x, a, b))304    if a in IRR or b in IRR:305        kind = "rounded"306    rows.append((str(x), a, b, text, kind))307308# 1. every unit against its category reference, both ways (catalog coverage)309for uid, model in U.items():310    category = uid.split(".")[0]311    ref = f"{category}.{REF[category]}"312    if uid == ref:313        continue314    add("1", uid, ref)315    add("1", ref, uid)316317# 2. curated everyday and engineering conversions318CURATED = [319    ("1", "length.mi", "length.km"), ("12", "length.in", "length.ft"), ("1", "length.ft", "length.in"),320    ("5280", "length.ft", "length.mi"), ("1", "length.yd", "length.cm"), ("26.21875", "length.mi", "length.km"),321    ("42.195", "length.km", "length.mi"), ("1", "length.nmi", "length.mi"), ("1", "length.ly", "length.au"),322    ("1", "length.pc", "length.ly"), ("1", "length.furlong", "length.chain"), ("1", "length.mi", "length.furlong"),323    ("1", "length.chain", "length.rod"), ("1", "length.fathom", "length.yd"), ("1", "length.ftUS", "length.ft"),324    ("1000", "length.mil", "length.in"), ("1", "length.in", "length.um"), ("1", "length.angstrom", "length.pm"),325    ("1", "length.league", "length.nmi"), ("1", "length.arpent", "length.ft"), ("6371", "length.km", "length.nmi"),326    ("1", "length.Mm", "length.mm"), ("100", "length.yd", "length.m"), ("1.75", "length.m", "length.ft"),327    ("1", "area.acre", "area.ft2"), ("1", "area.mi2", "area.acre"), ("1", "area.ha", "area.acre"),328    ("1", "area.km2", "area.mi2"), ("1", "area.ft2", "area.in2"), ("1", "area.yd2", "area.ft2"),329    ("1", "area.arpent", "area.acre"), ("1", "area.arpent", "area.ha"), ("2500", "area.ft2", "area.m2"),330    ("1", "volume.gal_us", "volume.L"), ("1", "volume.gal_us", "volume.in3"), ("1", "volume.gal_imp", "volume.L"),331    ("1", "volume.gal_imp", "volume.gal_us"), ("1", "volume.gal_us", "volume.floz_us"),332    ("1", "volume.gal_imp", "volume.floz_imp"), ("1", "volume.floz_us", "volume.mL"),333    ("1", "volume.floz_imp", "volume.mL"), ("1", "volume.cup_us", "volume.mL"), ("1", "volume.tbsp_us", "volume.tsp_us"),334    ("1", "volume.tbsp_us", "volume.mL"), ("1", "volume.tsp_us", "volume.mL"), ("1", "volume.bbl", "volume.L"),335    ("1", "volume.bbl", "volume.gal_us"), ("1", "volume.ft3", "volume.L"), ("1", "volume.ft3", "volume.gal_us"),336    ("1", "volume.yd3", "volume.ft3"), ("1", "volume.pt_imp", "volume.mL"), ("1", "volume.pt_us", "volume.mL"),337    ("1", "volume.cup_metric", "volume.cup_us"), ("1", "volume.L", "volume.cm3"), ("1", "volume.qt_us", "volume.L"),338    ("355", "volume.mL", "volume.floz_us"), ("1", "volume.pt_imp", "volume.floz_imp"),339    ("1", "mass.lb", "mass.g"), ("1", "mass.lb", "mass.oz"), ("1", "mass.kg", "mass.lb"), ("1", "mass.oz", "mass.g"),340    ("1", "mass.st", "mass.kg"), ("1", "mass.ton_us", "mass.t"), ("1", "mass.ton_uk", "mass.t"),341    ("1", "mass.ton_uk", "mass.ton_us"), ("1", "mass.ozt", "mass.g"), ("1", "mass.ozt", "mass.oz"),342    ("1", "mass.lb", "mass.gr"), ("1", "mass.gr", "mass.mg"), ("1", "mass.ct", "mass.mg"),343    ("1", "mass.slug", "mass.lb"), ("12", "mass.u", "mass.g"), ("70", "mass.kg", "mass.st"),344    ("154.5", "mass.lb", "mass.kg"),345    ("0", "temperature.degC", "temperature.degF"), ("0", "temperature.degC", "temperature.K"),346    ("100", "temperature.degC", "temperature.degF"), ("-40", "temperature.degC", "temperature.degF"),347    ("-40", "temperature.degF", "temperature.degC"), ("0", "temperature.K", "temperature.degC"),348    ("0", "temperature.K", "temperature.degF"), ("0", "temperature.degR", "temperature.degF"),349    ("98.6", "temperature.degF", "temperature.degC"), ("37", "temperature.degC", "temperature.degF"),350    ("0", "temperature.degF", "temperature.degC"), ("273.16", "temperature.K", "temperature.degC"),351    ("491.67", "temperature.degR", "temperature.degC"), ("451", "temperature.degF", "temperature.K"),352    ("5778", "temperature.K", "temperature.degF"), ("-273.15", "temperature.degC", "temperature.degR"),353    ("100", "speed.km_h", "speed.mph"), ("60", "speed.mph", "speed.km_h"), ("1", "speed.kn", "speed.km_h"),354    ("1", "speed.kn", "speed.mph"), ("1", "speed.mach", "speed.km_h"), ("1", "speed.c", "speed.km_s"),355    ("88", "speed.ft_s", "speed.mph"), ("1", "speed.mph", "speed.ft_s"), ("120", "speed.km_h", "speed.m_s"),356    ("1", "acceleration.g0", "acceleration.ft_s2"), ("1", "acceleration.g0", "acceleration.Gal"),357    ("1", "pressure.atm", "pressure.psi"), ("1", "pressure.atm", "pressure.Torr"), ("1", "pressure.atm", "pressure.mmHg"),358    ("1", "pressure.atm", "pressure.bar"), ("1", "pressure.atm", "pressure.inHg"), ("1", "pressure.bar", "pressure.psi"),359    ("1", "pressure.psi", "pressure.kPa"), ("32", "pressure.psi", "pressure.bar"), ("1", "pressure.at", "pressure.psi"),360    ("760", "pressure.Torr", "pressure.atm"), ("1", "pressure.mmHg", "pressure.Torr"), ("29.92", "pressure.inHg", "pressure.hPa"),361    ("1013.25", "pressure.mbar", "pressure.atm"), ("1", "pressure.ksi", "pressure.MPa"), ("1", "pressure.inH2O", "pressure.cmH2O"),362    ("1", "energy.kWh", "energy.MJ"), ("1", "energy.kcal", "energy.kJ"), ("1", "energy.BTU", "energy.cal_IT"),363    ("1", "energy.BTU", "energy.ftlbf"), ("1", "energy.kWh", "energy.BTU"), ("1", "energy.therm_us", "energy.kWh"),364    ("1", "energy.therm_ec", "energy.BTU"), ("1", "energy.J", "energy.eV"), ("1", "energy.tTNT", "energy.kWh"),365    ("1", "energy.J", "energy.erg"), ("2000", "energy.kcal", "energy.kJ"), ("1", "energy.cal_IT", "energy.cal"),366    ("1", "energy.MeV", "energy.J"), ("1", "energy.kWh", "energy.kcal"), ("1", "energy.ftlbf", "energy.cal"),367    ("1", "power.hp", "power.kW"), ("1", "power.hp_metric", "power.kW"), ("1", "power.hp", "power.hp_metric"),368    ("1", "power.hp", "power.ftlbf_s"), ("1", "power.TR", "power.BTU_h"), ("1", "power.TR", "power.kW"),369    ("1", "power.kW", "power.BTU_h"), ("1", "power.hp_electric", "power.hp"), ("100", "power.kW", "power.hp"),370    ("1", "force.lbf", "force.N"), ("1", "force.kgf", "force.lbf"), ("1", "force.kip", "force.kN"),371    ("1", "force.lbf", "force.pdl"), ("1", "force.N", "force.dyn"), ("1", "force.lbf", "force.ozf"),372    ("1", "time.d", "time.min"), ("1", "time.wk", "time.h"), ("1", "time.a_julian", "time.d"),373    ("1", "time.a_gregorian", "time.d"), ("1", "time.mo", "time.d"), ("1", "time.fortnight", "time.us"),374    ("1", "time.century", "time.a_julian"), ("1", "time.a_tropical", "time.d"), ("1", "time.decade", "time.mo"),375    ("1", "time.y365", "time.wk"), ("90", "time.min", "time.h"), ("1", "time.a_gregorian", "time.a_julian"),376    ("180", "angle.deg", "angle.rad"), ("1", "angle.rad", "angle.deg"), ("1", "angle.turn", "angle.rad"),377    ("1", "angle.deg", "angle.arcmin"), ("1", "angle.deg", "angle.arcsec"), ("100", "angle.gon", "angle.deg"),378    ("1", "angle.turn", "angle.gon"), ("1", "angle.rad", "angle.arcsec"), ("1", "angle.mrad", "angle.arcmin"),379    ("1", "angle.rad", "angle.mrad"), ("90", "angle.deg", "angle.turn"),380    ("1", "dataStorage.KiB", "dataStorage.B"), ("1", "dataStorage.kB", "dataStorage.B"),381    ("1", "dataStorage.GiB", "dataStorage.GB"), ("1", "dataStorage.GB", "dataStorage.GiB"),382    ("1", "dataStorage.TB", "dataStorage.TiB"), ("1", "dataStorage.YiB", "dataStorage.YB"),383    ("1", "dataStorage.MiB", "dataStorage.KiB"), ("1", "dataStorage.B", "dataStorage.nibble"),384    ("1", "dataStorage.MB", "dataStorage.Mbit"), ("500", "dataStorage.GB", "dataStorage.GiB"),385    ("1", "dataStorage.Gibit", "dataStorage.MiB"), ("1", "dataStorage.ZiB", "dataStorage.EiB"),386    ("100", "dataRate.Mbit_s", "dataRate.MB_s"), ("1", "dataRate.Gbit_s", "dataRate.MiB_s"),387    ("1", "dataRate.MiB_s", "dataRate.Mbit_s"), ("1", "dataRate.GB_s", "dataRate.Gbit_s"),388    ("1", "dataRate.kB_s", "dataRate.kbit_s"), ("1", "dataRate.GiB_s", "dataRate.MiB_s"),389    ("8", "fuelEconomy.L_100km", "fuelEconomy.mpg_us"), ("8", "fuelEconomy.L_100km", "fuelEconomy.mpg_imp"),390    ("30", "fuelEconomy.mpg_us", "fuelEconomy.L_100km"), ("30", "fuelEconomy.mpg_imp", "fuelEconomy.L_100km"),391    ("5", "fuelEconomy.L_100km", "fuelEconomy.km_L"), ("12.5", "fuelEconomy.km_L", "fuelEconomy.L_100km"),392    ("30", "fuelEconomy.mpg_us", "fuelEconomy.mpg_imp"), ("30", "fuelEconomy.mpg_us", "fuelEconomy.km_L"),393    ("10", "fuelEconomy.L_100km", "fuelEconomy.L_100km"), ("25", "fuelEconomy.mpg_us", "fuelEconomy.gal_100mi_us"),394    ("4", "fuelEconomy.gal_100mi_us", "fuelEconomy.L_100km"), ("6.5", "fuelEconomy.L_100km", "fuelEconomy.mi_L"),395    ("235.214583", "fuelEconomy.L_100km", "fuelEconomy.mpg_us"),396    ("3000", "frequency.rpm", "frequency.Hz"), ("1", "frequency.Hz", "frequency.rad_s"),397    ("1", "frequency.rpm", "frequency.rad_s"), ("2.4", "frequency.GHz", "frequency.MHz"),398    ("1", "torque.lbfft", "torque.Nm"), ("1", "torque.lbfft", "torque.lbfin"), ("1", "torque.kgfm", "torque.lbfft"),399    ("100", "torque.Nm", "torque.lbfft"), ("1", "torque.lbfin", "torque.ozfin"),400    ("1", "density.g_cm3", "density.lb_ft3"), ("1", "density.lb_gal_us", "density.kg_L"),401    ("1", "density.lb_in3", "density.g_cm3"), ("62.4", "density.lb_ft3", "density.kg_m3"),402    ("1", "flowRate.gal_min_us", "flowRate.L_min"), ("1", "flowRate.ft3_min", "flowRate.L_s"),403    ("1", "flowRate.m3_h", "flowRate.L_min"), ("1", "flowRate.ft3_s", "flowRate.gal_min_us"),404    ("1", "flowRate.ft3_min", "flowRate.m3_h"),405    ("1", "electricCharge.Ah", "electricCharge.C"), ("5000", "electricCharge.mAh", "electricCharge.Ah"),406    ("1", "electricCharge.C", "electricCharge.e"), ("1", "electricCharge.mAh", "electricCharge.C"),407    ("1", "voltage.kV", "voltage.mV"), ("1", "electricCurrent.A", "electricCurrent.uA"),408    ("4.7", "resistance.kohm", "resistance.ohm"), ("1", "resistance.Mohm", "resistance.mohm"),409    ("1", "capacitance.uF", "capacitance.pF"), ("100", "capacitance.nF", "capacitance.uF"),410    ("1", "inductance.mH", "inductance.uH"),411    ("1", "dynamicViscosity.cP", "dynamicViscosity.mPas"), ("1", "dynamicViscosity.P", "dynamicViscosity.cP"),412    ("1", "kinematicViscosity.St", "kinematicViscosity.cSt"), ("1", "kinematicViscosity.ft2_s", "kinematicViscosity.cSt"),413    ("1", "illuminance.fc", "illuminance.lx"), ("1", "illuminance.ph", "illuminance.fc"),414    ("1", "radioactivity.Ci", "radioactivity.GBq"), ("1", "radioactivity.mCi", "radioactivity.MBq"),415    ("1", "absorbedDose.Gy", "absorbedDose.rad"), ("1", "doseEquivalent.Sv", "doseEquivalent.rem"),416    ("1", "doseEquivalent.mrem", "doseEquivalent.uSv"),417    ("12", "typography.pt", "typography.px"), ("1", "typography.pc", "typography.pt"),418    ("72", "typography.pt", "typography.in"), ("96", "typography.px", "typography.mm"),419    ("1", "typography.pt", "typography.mm"),420]421for x, a, b in CURATED:422    add(x, a, b)423424# A few of the curated expectations, spelled out from textbooks, as a guard on this script itself.425def expect(x, a, b, text):426    assert render(convert(x, a, b))[0] == text, (a, b, render(convert(x, a, b)))427428expect("1", "length.mi", "length.km", "1.609344")429expect("12", "length.in", "length.ft", "1")430expect("1", "mass.lb", "mass.g", "453.59237")431expect("1", "volume.gal_us", "volume.L", "3.785411784")432expect("1", "volume.gal_us", "volume.in3", "231")433expect("-40", "temperature.degC", "temperature.degF", "-40")434expect("0", "temperature.degC", "temperature.degF", "32")435expect("98.6", "temperature.degF", "temperature.degC", "37")436expect("0", "temperature.K", "temperature.degF", "-459.67")437expect("1", "area.acre", "area.ft2", "43560")438expect("1", "area.mi2", "area.acre", "640")439expect("1", "energy.BTU", "energy.cal_IT", "251.9957611111111111111111111111111")440expect("1", "energy.kWh", "energy.MJ", "3.6")441expect("1", "dataStorage.GiB", "dataStorage.GB", "1.073741824")442expect("1", "pressure.atm", "pressure.Torr", "760")443expect("1", "time.a_julian", "time.d", "365.25")444expect("90", "angle.deg", "angle.turn", "0.25")445expect("1", "power.hp", "power.ftlbf_s", "550")446assert abs(float(convert("8", "fuelEconomy.L_100km", "fuelEconomy.mpg_us")) - 29.40182289) < 1e-7447assert abs(float(convert("1", "pressure.atm", "pressure.psi")) - 14.6959488) < 1e-6448assert abs(float(convert("1", "length.pc", "length.ly")) - 3.261563777) < 1e-8449450# --------------------------------------------------------------------------- rate conventions451getcontext().prec = 60452def D(x):453    return Decimal(x)454455def eff_from(kind, m, r):456    r = D(r)457    if kind == "effective": return r458    if kind == "nominal": return (1 + r / m) ** m - 1459    if kind == "periodic": return (1 + r) ** m - 1460    if kind == "continuous": return r.exp() - 1461    if kind == "discount": return 1 / (1 - r) - 1462    if kind == "nominalDiscount": return (1 - r / m) ** (-m) - 1463    raise ValueError(kind)464465def eff_to(kind, m, i):466    one = 1 + i467    if kind == "effective": return i468    if kind == "nominal": return m * ((one.ln() / m).exp() - 1)469    if kind == "periodic": return (one.ln() / m).exp() - 1470    if kind == "continuous": return one.ln()471    if kind == "discount": return 1 - 1 / one472    if kind == "nominalDiscount": return m * (1 - (-one.ln() / m).exp())473    raise ValueError(kind)474475CONV = [("effective", 0), ("nominal", 1), ("nominal", 2), ("nominal", 4), ("nominal", 12), ("nominal", 52),476        ("nominal", 365), ("continuous", 0), ("periodic", 12), ("periodic", 4), ("discount", 0),477        ("nominalDiscount", 12), ("nominalDiscount", 2)]478rate_rows = []479for r in ["0.06", "0.0525", "0.12", "0.000001", "-0.01", "0.25"]:480    for fk, fm in CONV:481        if fk == "periodic" and r in ("0.25", "0.12"):482            continue483        for tk, tm in CONV:484            value = eff_to(tk, tm, eff_from(fk, fm, r))485            rate_rows.append((r, fk, fm, tk, tm, format(value.quantize(Decimal(10) ** -40), "f")))486487semi = eff_from("nominal", 2, "0.06")488assert semi == D("0.0609")489monthly = eff_to("nominal", 12, semi)490assert abs(monthly - D("0.059263464")) < D("1e-9"), monthly491492# --------------------------------------------------------------------------- output493here = Path(__file__).resolve().parent494tsv = "value\tfrom\tto\texpected\tkind\n" + "".join("\t".join(r) + "\n" for r in rows)495(here / "reference_conversions.tsv").write_text(tsv, encoding="utf-8")496rate_tsv = "rate\tfrom\tfromPeriods\tto\ttoPeriods\texpected\n" + "".join(497    "\t".join(str(c) for c in r) + "\n" for r in rate_rows)498(here / "reference_rates.tsv").write_text(rate_tsv, encoding="utf-8")499500swift = f'''// ORIX Calc501// File: Packages/ORIXUnits/Tests/ORIXUnitsTests/ReferenceData.swift502// Description: GENERATED by Reference/generate_reference.py — reference conversions computed with exact fractions. Do not edit.503//504// Author: Simon-Pierre Boucher505// Contact: contact@spboucher.ai506507/// Tab-separated: value, from id, to id, expected, exact|rounded ({len(rows)} rows, {SIG} significant digits when rounded).508let referenceConversionsTSV = """509{"".join(chr(10).join("\t".join(r) for r in rows))}510"""511512/// Tab-separated: rate, from kind, from periods, to kind, to periods, expected ({len(rate_rows)} rows).513let referenceRatesTSV = """514{chr(10).join(chr(9).join(str(c) for c in r) for r in rate_rows)}515"""516517/// Number of unit ids known to the reference script.518let referenceUnitCount = {len(U)}519'''520(here.parent / "Tests" / "ORIXUnitsTests" / "ReferenceData.swift").write_text(swift, encoding="utf-8")521print(f"units: {len(U)}  categories: {len(REF)}  conversions: {len(rows)} "522      f"(exact: {sum(1 for r in rows if r[4] == 'exact')})  rate rows: {len(rate_rows)}")523print(f"6% nominal semi-annual -> effective {semi} -> nominal monthly {monthly:.20f}")524
Files main
Menu

Theme