ucum-org / ucum

https://ucum.org
Other
48 stars 10 forks source link

Request for: Multiple units commonly used in the energy logistics industry #295

Open jhunt-implico opened 5 months ago

jhunt-implico commented 5 months ago

An application I am working on requires the units of measure described below – these are not currently declared in UCUM as far as I can tell, but are derived to the extent possible from the existing declared units and syntax rules. The application is an API for quantity-conversion equations used commonly in the oil/gas/energy logistics industries for custody-transfer operations. Many of these units are used in or calculated by the ASTM formulas for petroleum measurement conversions (for example ASTM D1250-04, https://www.astm.org/d1250-04.html); others are used in or calculated by ISO 13443:1996 formula B.16 for calculating volume-basis superior calorific values of an ideal gas and formula B.1 for calculating volume of an ideal gas (assuming a standard temperature of 60 °F and accepting US customary units), or in the OIML formula for alcohol-water-mass quantity conversions based on the IPTS-68 temperature scale and a standard temperature of 20 °C, recommended by the EG in 1976 and still in use. In addition, some terms such as "specific gravity" are less formally correct but are part of the definition of units used in the standards.

We want to be consistent with, but don't want to overload, the UCUM standard, inasmuch as energy-industry standards are evolving and new units will need to be supported in the future. So it may be that some of these should not be explicitly included and instead simply left to the implementation.


Cel{vol} # temperature in degrees Celsius at which volume was determined

Cel{kg/m3} # temperature in degrees Celsius at which density in kg/m3 was determined

[degF]{degAPI} # temperature in degrees Fahrenheit at which API gravity was determined

[degF]{vol} # temperature in degrees Fahrenheit at which volume was determined

[degF]{sg_60} # temperature in degrees Fahrenheit at which specific gravity (density relative to water at 60 °F) was determined

kg{alc} # mass in kilograms (of pure alcohol)

m3{15Cel} # volume in cubic meters (at 15 °C)

m3{20Cel} # volume in cubic meters (at 20 °C)

%{mass} # percent by mass, i.e. 1/100 kg/kg; is equal to mass fraction × 100

[gal_us]{60degF} # U.S. gallons at 60 °F

[bbl_us]{60degF} # U.S. barrels at 60 °F

L{15Cel} # volume in liters (at 15 °C)

L{20Cel} # volume in liters (at 20 °C)

L{alc'20Cel} # volume in liters (of pure alcohol at 20 °C)

kg/m3{15Cel} # density (at 15 °C)

kg/m3{20Cel} # density (at 20 °C)

kg[air_PTB] # weight approximated as L × [(kg / m3) – 1.1] / 1000; PTB = Physikalisch-Technische Bundesanstalt (German metrology institute); in fuel logistics this is a common way to approximate the effect of atmospheric buoyancy on a given mass (but is not the only way)

t[air_PTB] # weight as 1000 × kg[air_PTB]

%{vol'15Cel} # percent by volume (at 15 °C)

%{vol'20Cel} # percent by volume (at 20 °C)

{vol'corr'fact} # volume correction factor (factor by which to multiply volume)

[degAPI] # API gravity ("degrees API"), i.e. (141.5/SG@60°F) – 131.5, where SG = Specific Gravity

[degAPI]{60degF} # API gravity at 60 °F

10*6[Btu] # million British thermal unit (where [Btu] is any of the UCUM [Btu] variants, e.g. 10*6[Btu_59])

[Btu]/[cft_i] # British thermal unit per cubic foot (where [Btu] is any of the UCUM [Btu] variants, e.g. [Btu_59]/[cft_i])

[psi]{heat} # pressure in pound per square inch at which heat energy was determined

[psi]{vol} # pressure in pound per square inch at which volume was determined

[degF]{heat} # temperature in degrees Fahrenheit at which heat energy was determined

10*3[cft_i] # thousand cubic foot

{heat'corr'fact} # heat energy correction factor (factor by which to multiply heat energy)

/Cel # rate of change per °C: 1/°C (e.g. coefficient of thermal expansion)

/degF{60degF} # rate of change per °F: 1/°F at 60°F (e.g. coefficient of thermal expansion)

[sg_60] # specific gravity (relative density) as the ratio of density of a material at an observed temperature to the density of water at 60°F

[sg_60]{60degF} # specific gravity (relative density) as the ratio of density of a material at 60 °F to the density of water at 60°F