Highlighted features
Dispatch on dimensions
Consider the following toy example, converting from voltage or power ratios to decibels:
julia> whatsit(x::Unitful.Voltage) = "voltage!"
whatsit (generic function with 1 method)
julia> whatsit(x::Unitful.Length) = "length!"
whatsit (generic function with 2 methods)
julia> whatsit(1u"mm")
"length!"
julia> whatsit(1u"kV")
"voltage!"
julia> whatsit(1u"A" * 2.5u"Ω")
"voltage!"Dimensions in a type definition
It may be tempting to specify the dimensions of a quantity in a type definition, e.g.
struct Person
height::Unitful.Length
mass::Unitful.Mass
endHowever, these are abstract types. If performance is important, it may be better just to pick a concrete Quantity type:
struct Person
height::typeof(1.0u"m")
mass::typeof(1.0u"kg")
endYou can still create a Person as Person(5u"ft"+10u"inch", 75u"kg"); the unit conversion happens automatically.
Making new units and dimensions
You can make new units using the @unit macro on the fly:
julia> @unit yd5 "yd5" FiveYards 5u"yd" false
yd5Arrays
Promotion is used to create arrays of a concrete type where possible, such that arrays of unitful quantities are stored efficiently in memory. However, if necessary, arrays can hold quantities with different dimensions, even mixed with unitless numbers. Doing so will suffer a performance penalty compared with the fast performance attainable with an array of concrete type (e.g. as resulting from [1.0u"m", 2.0u"cm", 3.0u"km"]). However, it could be useful in toy calculations for general relativity where some conventions yield matrices with mixed dimensions:
julia> using LinearAlgebra
julia> Diagonal([-1.0u"c^2", 1.0, 1.0, 1.0]);