2
2
3
3
* Measurements.jl compatibility layer for UnitSystems.jl*
4
4
5
+ [ ![ DOI] ( https://zenodo.org/badge/372081673.svg )] ( https://zenodo.org/badge/latestdoi/372081673 )
6
+ [ ![ Build status] ( https://ci.appveyor.com/api/projects/status/rxo2lh76n3dr31c0?svg=true )] ( https://ci.appveyor.com/project/chakravala/measuresystems-jl )
7
+
8
+ In aggregate, the ` UnitSystem ` data generated here constitutes a new universal standardization for dimensional analysis, which generalizes upon previous historical systems up to the 2019 redefinition and unifies them in a common ` Universe ` .
9
+ This enables a more precise and generalized standardization than the 2019 redefinition, which was comparatively limited in scope.
10
+ Specified default ` UnitSystem ` values are to be taken as a newly defined mutually-compatible recommended standard, verified to be consistent and coherent.
11
+ A ` UnitSystem ` can only be useful as a measuring standard if it can be scientifically reproduced, so the data here has been implemented in several important scientific programming languages (initially in the Julia language but also Wolfram language and Rust langauge) as well as presented abstractly in terms of dimensional formulas.
12
+
5
13
> In fact there is nothing transcendental about dimensions; the ultimate principle is precisely expressible (in Newton's terminology) as one of * similitude* , exact or approximate, to be tested by the rule that mere change in the magnitudes of the ordered scheme of units of measurement that is employed must not affect sensibly the forms of the equations that are the adequate expression of the underlying relations of the problem. (J.L., 1914)
6
14
7
15
Specifications for dimensional units are in the [ UnitSystems.jl] ( https://github.com/chakravala/UnitSystems.jl ) and [ Similitude.jl] ( https://github.com/chakravala/Similitude.jl ) and [ MeasureSystems.jl] ( https://github.com/chakravala/MeasureSystems.jl ) repositories.
8
16
The three packages are designed so that they can be interchanged with compatibility.
9
17
On its own ` UnitSystems ` is the fastest package, while ` Similitude ` (provides ` Quantity ` type) and ` MeasureSystems ` (introduces [ Measurements.jl] ( https://github.com/JuliaPhysics/Measurements.jl ) uncertainty) build additional features on top of ` UnitSystems ` base defintions.
10
18
Additionally, in the ` UnitSystems ` repository there is an equivalent [ Wolfram language paclet] ( https://reference.wolfram.com/language/guide/Paclets ) ` Kernel ` and also an unmaintained Rust ` src ` implementation.
11
- Defaults are shared across the packages : ` Metric ` , ` SI2019 ` , ` CODATA ` , ` Conventional ` , ` International ` , ` InternationalMean ` , ` MetricEngineering ` , ` SI2019Engineering ` , ` GravitationalMetric ` , ` GravitationalSI2019 ` , ` British ` , ` British2019 ` , ` Survey ` , ` Survey2019 ` , ` English ` , ` English2019 ` , ` FPS ` , ` FPS2019 ` , ` Gauss ` , ` LorentzHeaviside ` , ` Thomson ` , ` EMU ` , ` ESU ` , ` EMU2019 ` , ` ESU2019 ` , ` IAU ` , ` IAUE ` , ` IAUJ ` , ` Astronomical ` , ` Hubble ` , ` Cosmological ` , ` CosmologicalQuantum ` , ` Nautical ` , ` MPH ` , ` KKH ` , ` MTS ` , ` FFF ` , ` Planck ` , ` PlanckGauss ` , ` Stoney ` , ` Hartree ` , ` Rydberg ` , ` Schrodinger ` , ` Electronic ` , ` Natural ` , ` NaturalGauss ` , ` QCD ` , ` QCDGauss ` , and ` QCDoriginal ` .
19
+ Defaults are shared: ` Metric ` , ` SI2019 ` , ` CODATA ` , ` Conventional ` , ` International ` , ` InternationalMean ` , ` MetricEngineering ` , ` SI2019Engineering ` , ` GravitationalMetric ` , ` GravitationalSI2019 ` , ` FPS ` , ` IPS ` , ` British ` , ` English ` , ` Survey ` , ` Gauss ` , ` LorentzHeaviside ` , ` EMU ` , ` ESU ` , ` IAU ` , ` IAUE ` , ` IAUJ ` , ` Hubble ` , ` Cosmological ` , ` CosmologicalQuantum ` , ` Meridian ` , ` Nautical ` , ` MPH ` , ` KKH ` , ` MTS ` , ` FFF ` , ` Planck ` , ` PlanckGauss ` , ` Stoney ` , ` Hartree ` , ` Rydberg ` , ` Schrodinger ` , ` Electronic ` , ` Natural ` , ` NaturalGauss ` , ` QCD ` , ` QCDGauss ` , ` QCDoriginal ` .
12
20
13
21
``` Julia
14
22
julia> using MeasureSystems # or UnitSystems or Similitude
@@ -20,35 +28,38 @@ Eleven fundamental constants `kB`, `ħ`, `𝘤`, `μ₀`, `mₑ`, `Mᵤ`, `Kcd`,
20
28
These are the constants ` boltzmann ` , ` planckreduced ` , ` lightspeed ` , ` vacuumpermeability ` , ` electronmass ` , ` molarmass ` , ` luminousefficacy ` , ` angle ` , ` rationalization ` , ` lorentz ` , and ` gravity ` .
21
29
Different choices of natural units or physical measurements result in a variety of unit systems for many purposes.
22
30
23
- Main documentation is at https://geophysics.crucialflow.com/dev/units
31
+ Main documentation is at https://geophysics.crucialflow.com/dev/unitsystems
24
32
25
33
Historically, older electromagnetic unit systems also relied on a ` rationalization ` constant ` λ ` and a ` lorentz ` force proportionality constant ` αL ` .
26
- In most unit systems these extra constants have a value of ` 1 ` unless otherwise specified.
34
+ In most unit systems these extra constants have a value of ` 1 ` unless specified.
27
35
28
36
``` Julia
29
37
UnitSystem{kB, ħ, 𝘤, μ₀, mₑ, Mᵤ, (Kcd, θ, λ, αL, g₀, ... )}
30
38
```
31
39
32
40
Fundamental constants of physics are: ` kB ` Boltzmann's constant, ` ħ ` reduced Planck's constant, ` 𝘤 ` speed of light, ` μ₀ ` vacuum permeability, ` mₑ ` electron rest mass, ` Mᵤ ` molar mass, ` Kcd ` luminous efficacy, ` θ ` angle measure, ` λ ` Gauss rationalization, ` αL ` Lorentz's constant, and ` g₀ ` gravitational force reference.
33
41
Primarily the ` Metric ` SI unit system is used in addition to the historic ` English ` engineering unit system.
34
- These constants induce derived values for ` avogadro ` , ` boltzmann ` , ` universalgas ` , ` planck ` , ` planckreduced ` , ` lightspeed ` , ` planckmass ` , ` atomicmass ` , ` protonmass ` , ` electronmass ` , ` newton ` , ` einstein ` , ` vacuumpermeability ` , ` vacuumpermittivity ` , ` coulomb ` , and
35
- additional constants ` molarmass ` , ` luminousefficacy ` , ` gravity ` , ` angle ` , ` turn ` , ` sphere ` , ` stefan ` , ` radiationdensity ` , ` ampere ` , ` lorentz ` , ` biotsavart ` , ` rationalization ` , ` vacuumimpedance ` , ` elementarycharge ` , ` magneton ` , ` conductancequantum ` , ` faraday ` , ` magneticfluxquantum ` , ` josephson ` , ` klitzing ` , ` hartree ` , ` rydberg ` , ` bohr ` , ` bohrreduced ` .
36
- Derived quantities are ` second ` , ` minute ` , ` hour ` , ` day ` , ` year ` , ` gaussianyear ` , ` siderealyear ` , ` hyperfine ` , ` hubble ` , ` cosmological ` , ` solarmass ` , ` earthmass ` , ` jupitermass ` , ` lunarmass ` , ` astronomicalunit ` , ` lunardistance ` , ` mile ` , ` clarkemile ` , ` nauticalmile ` , ` parsec ` , ` lightyear ` , ` gallon ` , ` litre ` , ` standardgravity ` , ` standardtemperature ` , ` standardpressure ` , ` inchmercury ` , ` torr ` , ` kilocalorie ` , ` calorie ` , ` meancalorie ` , ` thermalunit ` , ` tonsrefrigeration ` , ` horsepower ` , ` horsepowerwatt ` , ` horsepowermetric ` , ` electricalhorsepower ` , ` boilerhorsepower ` .
42
+ These constants induce derived values for ` avogadro ` , ` boltzmann ` , ` molargas ` , ` planck ` , ` planckreduced ` , ` lightspeed ` , ` planckmass ` , ` atomicmass ` , ` protonmass ` , ` electronmass ` , ` newton ` , ` einstein ` , ` vacuumpermeability ` , ` vacuumpermittivity ` , ` electrostatic ` , and
43
+ additional constants ` molarmass ` , ` luminousefficacy ` , ` gravity ` , ` angle ` , ` turn ` , ` spat ` , ` stefan ` , ` radiationdensity ` , ` magnetostatic ` , ` lorentz ` , ` biotsavart ` , ` rationalization ` , ` vacuumimpedance ` , ` elementarycharge ` , ` magneton ` , ` conductancequantum ` , ` faraday ` , ` magneticfluxquantum ` , ` josephson ` , ` klitzing ` , ` hartree ` , ` rydberg ` , ` bohr ` .
37
44
38
45
Physics constant documentation is at https://geophysics.crucialflow.com/dev/constants
39
46
40
- Additional reference ` UnitSystem ` variants: ` EMU ` , ` ESU ` , ` Gauss ` , ` LorentzHeaviside ` , ` SI2019 ` , ` SI1976 ` , ` CODATA ` , ` Conventional ` , ` International ` , ` InternationalMean ` , ` MetricEngineering ` , ` GravitationalMetric ` , ` Astronomical ` , ` Hubble ` , ` Cosmological ` , ` CosmologicalQuantum ` , ` IAU ` , ` IAUE ` , ` IAUJ ` , ` MTS ` , ` FPS ` , ` British ` , ` Survey ` , ` Nautical ` , ` MPH ` , ` KKH ` , ` FFF ` ; and natural atomic units based on gravitational ` coupling ` and ` finestructure ` constant (` Planck ` , ` PlanckGauss ` , ` Stoney ` , ` Hartree ` , ` Rydberg ` , ` Schrodinger ` , ` Electronic ` , ` Natural ` , ` NaturalGauss ` , ` QCD ` , ` QCDGauss ` , and ` QCDoriginal ` ).
47
+ Standardized unit/derived quantities are `hyperfine`, `loschmidt`, `wienwavelength`, `wienfrequency`, `mechanicalheat`, `solarmass`, `jupitermass`, `earthmass`, `lunarmass`, `earthradius`, `greatcircle`, `radarmile`, `hubble`, `cosmological`, `radian`, `steradian`, `degree`, `gradian`, `arcminute`, `arcsecond`, `second`, `minute`, `hour`, `day`, `year`, `gaussianyear`, `siderealyear`, `angstrom`, `inch`, `foot`, `surveyfoot`, `yard`, `meter`, `earthmeter`, `mile`, `statutemile`, `meridianmile`, `admiraltymile`, `nauticalmile`, `lunardistance`, `astronomicalunit`, `lightyear`, `parsec`, `barn`, `hectare`, `acre`, `surveyacre`, `liter`, `gallon`, `quart`, `pint`, `cup`, `fluidounce`, `teaspoon`, `tablespoon`, `grain`, `gram`, `earthgram`, `kilogram`, `tonne`, `ton`, `pound`, `ounce`, `slug`, `slinch`, `hyl`, `dyne`, `newton`, `poundal`, `poundforce`, `kilopond`, `psi`, `pascal`, `bar`, `barye`, `technicalatmosphere`, `atmosphere`, `inchmercury`, `torr`, `electronvolt`, `erg`, `joule`, `footpound`, `calorie`, `kilocalorie`, `meancalorie`, `earthcalorie`, `thermalunit`, `gasgallon`, `tontnt`, `watt`, `horsepower`, `horsepowerwatt`, `horsepowermetric`, `electricalhorsepower`, `tonsrefrigeration`, `boilerhorsepower`, `coulomb`, `earthcoulomb`, `ampere`, `volt`, `henry`, `ohm`, `siemens`, `farad`, `weber`, `tesla`, `abcoulomb`, `abampere`, `abvolt`, `abhenry`, `abohm`, `abmho`, `abfarad`, `maxwell`, `gauss`, `oersted`, `gilbert`, `statcoulomb`, `statampere`, `statvolt`, `stathenry`, `statohm`, `statmho`, `statfarad`, `statweber`, `stattesla`, `kelvin`, `rankine`, `sealevel`, `mole`, `earthmole`, `poundmole`, `slugmole`, `slinchmole`, `katal`, `amagat`, `lumen`, `candela`, `lux`, `phot`, `footcandle`, `nit`, `apostilb`, `stilb`, `lambert`, `footlambert`, `bril`, `neper`, `bel`, `decibel`, `hertz`, `rpm`, `kayser`, `diopter`, `bubnoff`, `gforce`, `galileo`, `eotvos`, `darcy`, `poise`, `reyn`, `stokes`, `rayl`, `mpge`, `langley`, `jansky`, `solarflux`, `curie`, `sievert`, `roentgen`, `rem`.
48
+
49
+ Standard physics units are at https://geophysics.crucialflow.com/dev/units
50
+
51
+ Additional reference ` UnitSystem ` variants: ` EMU ` , ` ESU ` , ` Gauss ` , ` LorentzHeaviside ` , ` SI2019 ` , ` SI1976 ` , ` CODATA ` , ` Conventional ` , ` International ` , ` InternationalMean ` , ` MetricEngineering ` , ` GravitationalMetric ` , ` IAU ` , ` IAUE ` , ` IAUJ ` , ` FPS ` , ` IPS ` , ` British ` , ` Survey ` , ` Hubble ` , ` Cosmological ` , ` CosmologicalQuantum ` , ` Meridian ` , ` Nautical ` , ` MPH ` , ` KKH ` , ` MTS ` , ` FFF ` ; and natural atomic units based on gravitational ` coupling ` and ` finestructure ` constant (` Planck ` , ` PlanckGauss ` , ` Stoney ` , ` Hartree ` , ` Rydberg ` , ` Schrodinger ` , ` Electronic ` , ` Natural ` , ` NaturalGauss ` , ` QCD ` , ` QCDGauss ` , and ` QCDoriginal ` ).
41
52
42
53
Unit conversion documentation is at https://geophysics.crucialflow.com/dev/convert
43
54
44
55
** Derived Unit conversions:**
45
56
46
- Mechanics: ` angle ` , ` solidangle ` , ` time ` , ` length ` , ` area ` , ` volume ` , ` wavenumber ` , ` angularwavenumber ` , ` fuelefficiency ` , ` frequency ` , ` angularfrequency ` , ` frequencydrift ` , ` speed ` , ` acceleration ` , ` jerk ` , ` snap ` , ` crackle ` , ` pop ` , ` volumeflow ` ,
47
- ` inertia ` , ` mass ` , ` massflow ` , ` lineardensity ` , ` areadensity ` , ` density ` , ` specificweight ` , ` specificvolume ` , ` force ` , ` gforce ` , ` stiffness ` , ` pressure ` , ` compressibility ` , ` viscosity ` , ` diffusivity ` , ` rotationalinertia ` , ` impulse ` , ` momentum ` , ` angularmomentum ` , ` yank ` , ` energy ` , ` specificenergy ` , ` action ` , ` fluence ` , ` power ` , ` powerdensity ` , ` intensity ` , ` spectralflux ` , ` soundexposure ` , ` impedance ` , ` specificimpedance ` , ` admittance ` , ` compliance ` , ` inertance ` ;
48
- Electromagnetics: ` charge ` , ` chargedensity ` , ` linearchargedensity ` , ` exposure ` , ` mobility ` , ` current ` , ` currentdensity ` , ` resistance ` , ` conductance ` , ` resistivity ` , ` conductivity ` , ` capacitance ` , ` inductance ` , ` reluctance ` , ` permeance ` , ` permittivity ` , ` permeability ` , ` susceptibility ` , ` specificsusceptibility ` , ` demagnetizingfactor ` , ` vectorpotential ` , ` electricpotential ` , ` magneticpotential ` , ` electricfield ` , ` magneticfield ` , ` electricflux ` , ` magneticflux ` , ` electricfluxdensity ` , ` magneticfluxdensity ` , ` electricdipolemoment ` , ` magneticdipolemoment ` , ` electricpolarizability ` , ` magneticpolarizability ` , ` magneticmoment ` , ` magnetizability ` , ` magnetization ` , ` specificmagnetization ` , ` rigidity ` , ` polestrength ` ;
49
- Thermodynamics: ` temperature ` , ` entropy ` , ` specificentropy ` , ` volumeheatcapacity ` , ` thermalconductivity ` , ` thermalconductance ` , ` thermalresistance ` , ` thermalexpansion ` , ` lapserate ` ,
57
+ Mechanics: ` angle ` , ` solidangle ` , ` time ` , ` length ` , ` area ` , ` volume ` , ` wavenumber ` , ` angularwavenumber ` , ` fuelefficiency ` , ` numberdensity ` , ` frequency ` , ` angularfrequency ` , ` frequencydrift ` , ` speed ` , ` acceleration ` , ` jerk ` , ` snap ` , ` crackle ` , ` pop ` , ` volumeflow ` ,
58
+ ` inertia ` , ` mass ` , ` massflow ` , ` lineardensity ` , ` areadensity ` , ` density ` , ` specificweight ` , ` specificvolume ` , ` force ` , ` specificforce ` , ` gravityforce ` , ` pressure ` , ` compressibility ` , ` viscosity ` , ` diffusivity ` , ` rotationalinertia ` , ` impulse ` , ` momentum ` , ` angularmomentum ` , ` yank ` , ` energy ` , ` specificenergy ` , ` action ` , ` fluence ` , ` power ` , ` powerdensity ` , ` intensity ` , ` spectralflux ` , ` soundexposure ` , ` impedance ` , ` specificimpedance ` , ` admittance ` , ` compliance ` , ` inertance ` ;
59
+ Electromagnetics: ` charge ` , ` chargedensity ` , ` linearchargedensity ` , ` exposure ` , ` mobility ` , ` current ` , ` currentdensity ` , ` resistance ` , ` conductance ` , ` resistivity ` , ` conductivity ` , ` capacitance ` , ` inductance ` , ` reluctance ` , ` permeance ` , ` permittivity ` , ` permeability ` , ` susceptibility ` , ` specificsusceptibility ` , ` demagnetizingfactor ` , ` vectorpotential ` , ` electricpotential ` , ` magneticpotential ` , ` electricfield ` , ` magneticfield ` , ` electricflux ` , ` magneticflux ` , ` electricfluxdensity ` , ` magneticfluxdensity ` , ` electricdipolemoment ` , ` magneticdipolemoment ` , ` electricpolarizability ` , ` magneticpolarizability ` , ` magneticmoment ` , ` specificmagnetization ` , ` polestrength ` ;
60
+ Thermodynamics: ` temperature ` , ` entropy ` , ` specificentropy ` , ` volumeheatcapacity ` , ` thermalconductivity ` , ` thermalconductance ` , ` thermalresistivity ` , ` thermalresistance ` , ` thermalexpansion ` , ` lapserate ` ,
50
61
` molarmass ` , ` molality ` , ` mole ` , ` molarity ` , ` molarvolume ` , ` molarentropy ` , ` molarenergy ` , ` molarconductivity ` , ` molarsusceptibility ` , ` catalysis ` , ` specificity ` ,
51
- ` luminousflux ` , ` luminance ` , ` luminousenergy ` , ` luminousexposure ` , ` luminousefficacy ` .
62
+ ` luminousflux ` , ` luminousintensity ` , ` luminance ` , ` illuminance ` , ` luminousenergy ` , ` luminousexposure ` , ` luminousefficacy ` .
52
63
53
64
** Generalized dimensionless ` Coupling ` :**
54
65
0 commit comments