Repository Public MIT
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