Skip to content

isqx.usc

Definitions for U.S. customary and British imperial units (feet, slugs, pound force etc.).

The public API is the isqx.usc module.

usc ¤

United States customary and British Imperial units.

See: isqx._citations.SP811, isqx._citations.H44, isqx._citations.WMA1985.

R ¤

R = (Fraction(5, 9) * K).alias('rankine')

Thermodynamic Temperature (Rankine). Absolute scale.

FAHRENHEIT ¤

FAHRENHEIT = Translated(
    R, Decimal("-459.67"), "fahrenheit"
)

Thermodynamic Temperature (Fahrenheit). Absolute, translated scale. Cannot be composed with other units.

FT ¤

FT = (Decimal('0.3048') * M).alias('foot')

International foot.

FT_US_SURVEY ¤

FT_US_SURVEY = (Fraction(1200, 3937) * M).alias(
    "foot_us_survey"
)

U.S. survey foot, deprecated since Dec 31, 2022.

IN ¤

IN = (Fraction(1, 12) * FT).alias('inch')

International inch.

YD ¤

YD = (3 * FT).alias('yard')

International yard.

MI ¤

MI = (5280 * FT).alias('mile')

International mile, also known as statute mile.

NMI ¤

NMI = (1852 * M).alias('nautical_mile')

International nautical mile.

MIL ¤

MIL = (Fraction(1, 1000) * IN).alias('mil')

Thousandth of an inch, a unit of thickness (also known as thou).

HAND ¤

HAND = (4 * IN).alias('hand')

Unit of length, for measuring the height of horses.

POINT ¤

POINT = (Fraction(1, 72) * IN).alias('point')

Typographical point (desktop publishing).

ROD ¤

ROD = (Fraction(33, 2) * FT).alias('rod')

Rod, also known as pole or perch.

FURLONG ¤

FURLONG = (40 * ROD).alias('furlong')

Furlong.

FATHOM ¤

FATHOM = (6 * FT).alias('fathom')

Fathom, a unit of length used for water depth.

CABLE ¤

CABLE = (120 * FATHOM).alias('cable')

Cable length.

LEAGUE ¤

LEAGUE = (3 * MI).alias('league')

League.

LINK = (Fraction(66, 100) * FT).alias('link')

Gunter's link.

CHAIN ¤

CHAIN = (100 * LINK).alias('chain')

Gunter's chain.

SQ_YD ¤

SQ_YD = YD ** 2

ROOD ¤

ROOD = (1210 * SQ_YD).alias('rood')

Rood, an imperial unit of area.

SQ_FT ¤

SQ_FT = FT ** 2

ACRE ¤

ACRE = (43560 * SQ_FT).alias('acre')

International acre.

ACRE_SURVEY ¤

ACRE_SURVEY = (43560 * FT_US_SURVEY**2).alias("acre_survey")

U.S. survey acre.

SQ_BUILDING ¤

SQ_BUILDING = (100 * SQ_FT).alias('square_building')

Square building, used in the U.S. construction industry.

SQ_MI ¤

SQ_MI = MI ** 2

SQ_MIL ¤

SQ_MIL = MIL ** 2

CIRCULAR_MIL ¤

CIRCULAR_MIL = (LazyProduct((PI, (4, -1))) * SQ_MIL).alias(
    "circular_mil"
)

Circular mil, a unit of area for wire cross-sections.

CU_IN ¤

CU_IN = IN ** 3

GAL ¤

GAL = (231 * CU_IN).alias('gallon')

U.S. liquid gallon.

QUART ¤

QUART = (Fraction(1, 4) * GAL).alias('quart')

U.S. liquid quart.

PINT ¤

PINT = (Fraction(1, 2) * QUART).alias('pint')

U.S. liquid pint.

CUP ¤

CUP = (Fraction(1, 2) * PINT).alias('cup_measuring')

U.S. customary cup.

GILL ¤

GILL = (Fraction(1, 4) * PINT).alias('gill')

U.S. liquid gill.

FL_OZ ¤

FL_OZ = (Fraction(1, 128) * GAL).alias('ounce_fluid')

U.S. fluid ounce.

TABLESPOON ¤

TABLESPOON = (Fraction(1, 2) * FL_OZ).alias(
    "tablespoon_measuring"
)

U.S. customary tablespoon.

TEASPOON ¤

TEASPOON = (Fraction(1, 3) * TABLESPOON).alias(
    "teaspoon_measuring"
)

U.S. customary teaspoon.

BBL_FEDERAL_FERMENTED_LIQUOR ¤

BBL_FEDERAL_FERMENTED_LIQUOR = (31 * GAL).alias(
    "bbl_federal_fermented_liquor"
)

BBL_STATE_LIQUID ¤

BBL_STATE_LIQUID = ((31 + Fraction(1, 2)) * GAL).alias(
    "bbl_state_liquid"
)

BBL_FEDERAL_CISTERN ¤

BBL_FEDERAL_CISTERN = (36 * GAL).alias(
    "bbl_federal_cistern"
)

BBL_PROOF_SPIRIT ¤

BBL_PROOF_SPIRIT = (50 * GAL).alias('bbl_proof_spirit')

BBL_OIL ¤

BBL_OIL = (42 * GAL).alias('bbl_oil', allow_prefix=True)

U.S. standard barrel for crude oil and petroleum products.

DRAM_FL ¤

DRAM_FL = (Fraction(1, 8) * FL_OZ).alias('dram_fluid')

U.S. apothecaries' fluid dram.

MINIM ¤

MINIM = (Fraction(1, 60) * DRAM_FL).alias('minim')

U.S. apothecaries' minim.

BUSHEL ¤

BUSHEL = (Decimal('2150.42') * CU_IN).alias('bushel')

U.S. dry bushel.

BUSHEL_HEAPED ¤

BUSHEL_HEAPED = (Decimal("2747.715") * CU_IN).alias(
    "bushel_heaped"
)

U.S. heaped bushel.

PECK ¤

PECK = (Fraction(1, 4) * BUSHEL).alias('peck')

U.S. dry peck.

QUART_DRY ¤

QUART_DRY = (Fraction(1, 8) * PECK).alias('quart_dry')

U.S. dry quart.

PINT_DRY ¤

PINT_DRY = (Fraction(1, 2) * QUART_DRY).alias('pint_dry')

U.S. dry pint.

BBL_DRY ¤

BBL_DRY = (7056 * CU_IN).alias('bbl_dry')

U.S. standard barrel for fruits, vegetables and dry commodities (excluding cranberries).

BBL_CRANBERRY ¤

BBL_CRANBERRY = (5826 * CU_IN).alias('bbl_cranberry')

U.S. standard barrel for cranberries.

GAL_IMP ¤

GAL_IMP = (Decimal("4.54609") * L).alias("gallon_imperial")

British Imperial gallon.

BUSHEL_IMP ¤

BUSHEL_IMP = (8 * GAL_IMP).alias('bushel_imperial')

British Imperial bushel.

PECK_IMP ¤

PECK_IMP = (2 * GAL_IMP).alias('peck_imperial')

British Imperial peck.

QUARTER_IMP ¤

QUARTER_IMP = (8 * BUSHEL_IMP).alias('quarter_imperial')

British Imperial quarter.

QUART_IMP ¤

QUART_IMP = (Fraction(1, 4) * GAL_IMP).alias(
    "quart_imperial"
)

British Imperial quart.

PINT_IMP ¤

PINT_IMP = (Fraction(1, 2) * QUART_IMP).alias(
    "pint_imperial"
)

British Imperial pint.

FL_OZ_IMP ¤

FL_OZ_IMP = (Fraction(1, 160) * GAL_IMP).alias(
    "ounce_fluid_imperial"
)

British Imperial fluid ounce.

DRACHM_FL_IMP ¤

DRACHM_FL_IMP = (Fraction(1, 8) * FL_OZ_IMP).alias(
    "drachm_fluid_imperial"
)

British Imperial fluid drachm.

SCRUPLE_FL_IMP ¤

SCRUPLE_FL_IMP = (Fraction(1, 3) * DRACHM_FL_IMP).alias(
    "scruple_fluid_imperial"
)

British Imperial fluid scruple.

MINIM_IMP ¤

MINIM_IMP = (Fraction(1, 20) * SCRUPLE_FL_IMP).alias(
    "minim_imperial"
)

British Imperial minim.

ACRE_FOOT ¤

ACRE_FOOT = (ACRE * FT).alias('acre_foot')

Volume of water that covers one acre to a depth of one foot.

CORD ¤

CORD = (128 * FT ** 3).alias('cord')

Cord, a unit of volume for firewood.

WATER_TON ¤

WATER_TON = (224 * GAL_IMP).alias('water_ton')

Water ton, an English unit of volume, approximately the volume of a long ton of water.

LB ¤

LB = (Decimal('0.45359237') * KG).alias('pound')

Avoirdupois pound mass.

GRAIN ¤

GRAIN = (Fraction(1, 7000) * LB).alias('grain')

Grain. Equivalent across Avoirdupois, Troy, and Apothecaries' systems.

OZ ¤

OZ = (Fraction(1, 16) * LB).alias('ounce')

Avoirdupois ounce.

DRAM ¤

DRAM = (Fraction(1, 16) * OZ).alias('dram')

Avoirdupois dram.

CWT ¤

CWT = (100 * LB).alias('hundredweight')

Short hundredweight (also known as cental)

TON ¤

TON = (2000 * LB).alias('ton')

Short or net ton.

STONE ¤

STONE = (14 * LB).alias('stone')

Stone, a British unit of mass.

QUARTER ¤

QUARTER = (28 * LB).alias('quarter')

Quarter, a British unit of mass.

CWT_LONG ¤

CWT_LONG = (112 * LB).alias('hundredweight_long')

Long hundredweight.

TON_LONG ¤

TON_LONG = (2240 * LB).alias('ton_long')

Long, gross or shipper's ton.

LB_T ¤

LB_T = (5760 * GRAIN).alias('pound_troy')

Troy pound mass.

OZ_T ¤

OZ_T = (Fraction(1, 12) * LB_T).alias('ounce_troy')

Troy ounce.

DWT ¤

DWT = (Fraction(1, 20) * OZ_T).alias('pennyweight')

Pennyweight.

LB_AP ¤

LB_AP = (5760 * GRAIN).alias('pound_apothecaries')

Apothecaries' pound mass.

OZ_AP ¤

OZ_AP = (Fraction(1, 12) * LB_AP).alias(
    "ounce_apothecaries"
)

Apothecaries' ounce.

DRAM_AP ¤

DRAM_AP = (Fraction(1, 8) * OZ_AP).alias(
    "dram_apothecaries"
)

Apothecaries' dram.

SCRUPLE ¤

SCRUPLE = (Fraction(1, 3) * DRAM_AP).alias('scruple')

Apothecaries' scruple.

CARAT ¤

CARAT = (200 * (MILLI * G)).alias('carat')

Metric carat, for gemstones.

POINT_MASS ¤

POINT_MASS = (Fraction(1, 100) * CARAT).alias('point_mass')

Point, for gemstones.

ASSAY_TON ¤

ASSAY_TON = (Decimal('29.167') * G).alias('assay_ton')

Assay ton. The mass in milligrams of precious metal from one assay ton of ore gives the troy ounces per short ton.

QUINTAL ¤

QUINTAL = (100 * KG).alias('quintal')

Quintal, a historical unit of mass, now usually 100 kg.

KNOT ¤

KNOT = (NMI * HOUR ** -1).alias('knot')

Knot, one nautical mile per hour.

MPH ¤

MPH = (MI * HOUR ** -1).alias('mph')

Miles per hour.

FT_PERS2 ¤

FT_PERS2 = FT * S ** -2

Feet per second squared.

LBF ¤

LBF = (CONST_STANDARD_GRAVITY * LB * M_PERS2).alias('lbf')

Pound-force.

POUNDAL ¤

POUNDAL = (LB * FT * S ** -2).alias('poundal')

Poundal, the force required to accelerate 1 lb by 1 ft/s².

KIP ¤

KIP = (1000 * LBF).alias('kip')

PSI ¤

PSI = (LBF * IN ** -2).alias('psi')

Pound-force per square inch, a unit of pressure.

KSI ¤

KSI = (1000 * PSI).alias('ksi')

Kilo-pound-force per square inch, a unit of pressure.

PSF ¤

PSF = (LBF * SQ_FT ** -1).alias('psf')

Pound-force per square foot, a unit of pressure.

INHG ¤

INHG = (
    LazyProduct((CONST_DENSITY_HG, CONST_STANDARD_GRAVITY))
    * IN
).alias("inch_of_hg")

Inch of mercury, a unit of pressure.

INH2O ¤

INH2O = (
    LazyProduct((CONST_DENSITY_H2O, CONST_STANDARD_GRAVITY))
    * IN
).alias("inch_of_h2o")

Inch of water (conventional), a unit of pressure.

INH2O_4C ¤

INH2O_4C = (Decimal("249.082") * PA).alias(
    "inch_of_water_4c"
)

Inch of water at 4 °C (temperature of maximum water density).

INH2O_60F ¤

INH2O_60F = (Decimal("248.84") * PA).alias(
    "inch_of_water_60f"
)

Inch of water at 60 °F.

SLUG ¤

SLUG = (LBF * FT_PERS2 ** -1).alias('slug')

A unit of mass that accelerates by 1 ft/s² when a force of 1 lbf is exerted on it.

FT_LBF ¤

FT_LBF = (FT * LBF).alias('foot_pound')

Foot-pound, a unit of energy or work.

CAL_IT ¤

CAL_IT = (Decimal('4.1868') * J).alias('calorie_it')

Calorie (International Table).

CAL_TH ¤

CAL_TH = (Decimal('4.184') * J).alias('calorie_th')

Calorie (thermochemical).

CAL_MEAN ¤

CAL_MEAN = (Decimal('4.19002') * J).alias('calorie_mean')

Calorie (mean). The heat required to raise 1 g of water from 0 °C to 100 °C, divided by 100.

CAL_15C ¤

CAL_15C = (Decimal('4.18580') * J).alias('calorie_15c')

Calorie (at 15 °C). The heat required to raise 1 g of water from 14.5 °C to 15.5 °C.

CAL_20C ¤

CAL_20C = (Decimal('4.18190') * J).alias('calorie_20c')

Calorie (at 20 °C). The heat required to raise 1 g of water from 19.5 °C to 20.5 °C.

BTU_IT ¤

BTU_IT = (Decimal('1055.05585262') * J).alias('btu_it')

British thermal unit (International Table). The most widely used definition.

BTU_TH ¤

BTU_TH = (Decimal('1054.350') * J).alias('btu_th')

British thermal unit (thermochemical).

BTU_MEAN ¤

BTU_MEAN = (Decimal('1055.87') * J).alias('btu_mean')

British thermal unit (mean, from 32 °F to 212 °F, divided by 180).

BTU_39F ¤

BTU_39F = (Decimal('1059.67') * J).alias('btu_39f')

British thermal unit (at 39 °F).

BTU_59F ¤

BTU_59F = (Decimal('1054.80') * J).alias('btu_59f')

British thermal unit (at 59 °F). Used for American natural gas pricing.

BTU_60F ¤

BTU_60F = (Decimal('1054.68') * J).alias('btu_60f')

British thermal unit (at 60 °F).

QUAD ¤

QUAD = (10 ** 15 * BTU_IT).alias('quad')

Quad (International Table). Used by U.S. Department of Energy.

HP ¤

HP = (33000 * (FT * LBF * MIN ** -1)).alias('horsepower')

Mechanical horsepower (imperial). See: https://en.wikipedia.org/wiki/Horsepower#Imperial_horsepower

HP_METRIC ¤

HP_METRIC = (75 * (KGF * M * S**-1)).alias(
    "horsepower_metric"
)

HP_BOILER ¤

HP_BOILER = (Decimal("9809.50") * W).alias(
    "horsepower_boiler"
)

Boiler horsepower.

HP_ELECTRIC ¤

HP_ELECTRIC = (746 * W).alias('horsepower_electric')

Electrical horsepower.

HP_UK ¤

HP_UK = (Decimal('745.70') * W).alias('horsepower_uk')

UK horsepower.

HP_WATER ¤

HP_WATER = (Decimal("746.043") * W).alias(
    "horsepower_water"
)

Water horsepower.

MPG ¤

MPG = (MI * GAL ** -1).alias('miles_per_gallon')

Miles per gallon, a unit of fuel economy.