ferrunitas 0.4.0

A type-safe unit conversion library with compile-time dimensional analysis
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

//! Photometric & luminous intensity domain units.
//!
//! Includes luminous flux, illuminance and related optical perception based
//! quantities anchored in luminosity dimension.

use crate::system::defs::base::*;
use crate::system::defs::dimensionless::*;
use crate::system::defs::mechanics::*;
use crate::system::prefixes::*;
use crate::{quantity, unit};
use typenum::*;

// ===========================
// LUMINOUS FLUX (Steradiands are dimensionless in SI, so this is dimensionally equal to Luminious Intensity)
// ===========================
quantity!(LuminousFlux: M Z0, L Z0, T Z0, I Z0, Th Z0, N Z0, J P1; marked); // J

unit!(compound: Lumen, "lm", [(Candela, P1), (Steradian, P1)]; marked LuminousFlux);

// ===========================
// LUMINANCE
// ===========================
quantity!(Luminance: M Z0, L N2, T Z0, I Z0, Th Z0, N Z0, J P1); // L⁻² J

unit!(compound: Nit, "nt", [(Candela, P1), (Metre, N2)]; prefixable);

// ===========================
// ILLUMINANCE
// ===========================
quantity!(Illuminance: M Z0, L N2, T Z0, I Z0, Th Z0, N Z0, J P1; marked); // L⁻² J

unit!(compound: Lux, "lx", [(Lumen, P1), (SquareMetre, N1)]; prefixable, marked Illuminance);
unit!(prefix: Kilolux, Kilo, Lux);

// ===========================
// OPTICAL POWER (LENS)
// ===========================
quantity!(OpticalPower: M Z0, L N1, T Z0, I Z0, Th Z0, N Z0, J Z0; marked); // L⁻¹

unit!(compound: Dioptre, "D", [(Metre, N1)]; marked OpticalPower);

// ===========================
// LUMINOUS ENERGY
// ===========================
quantity!(LuminousEnergy: M Z0, L Z0, T P1, I Z0, Th Z0, N Z0, J P1; marked); // T J

unit!(compound: LumenSecond, "lm⋅s", [(Lumen, P1), (Second, P1)]; marked LuminousEnergy);
unit!(derived: Talbot, "T", (1, LumenSecond)); // Historical unit

// ===========================
// LUMINOUS EXPOSURE
// ===========================
quantity!(LuminousExposure: M Z0, L N2, T P1, I Z0, Th Z0, N Z0, J P1; marked); // L⁻² T J

unit!(compound: LuxSecond, "lx⋅s", [(Lux, P1), (Second, P1)]; marked LuminousExposure);

// ===========================
// LUMINOUS EFFICACY
// ===========================
quantity!(LuminousEfficacy: M N1, L N2, T P3, I Z0, Th Z0, N Z0, J P1; marked); // M⁻¹ L⁻² T³ J

unit!(compound: LumenPerWatt, "lm/W", [(Lumen, P1), (Watt, N1)]; marked LuminousEfficacy);

// ===========================
// RADIANCE
// ===========================
quantity!(Radiance: M P1, L Z0, T N3, I Z0, Th Z0, N Z0, J Z0; marked); // M T⁻³

unit!(compound: WattPerSquareMetreSteradian, "W/(m²⋅sr)", [(Watt, P1), (Metre, N2), (Steradian, N1)]; marked Radiance);

// ===========================
// RADIANT INTENSITY
// ===========================
quantity!(RadiantIntensity: M P1, L P2, T N3, I Z0, Th Z0, N Z0, J Z0; marked); // M L² T⁻³

unit!(compound: WattPerSteradian, "W/sr", [(Watt, P1), (Steradian, N1)]; marked RadiantIntensity);

// ===========================
// IRRADIANCE / RADIANT EXITANCE
// ===========================
quantity!(Irradiance: M P1, L Z0, T N3, I Z0, Th Z0, N Z0, J Z0); // M T⁻³

unit!(compound: WattPerSquareMetre, "W/m²", [(Watt, P1), (Metre, N2)]);

// ===========================
// SPECTRAL RADIANCE
// ===========================
quantity!(SpectralRadiance: M P1, L N1, T N3, I Z0, Th Z0, N Z0, J Z0; marked); // M L⁻¹ T⁻³

unit!(compound: WattPerSquareMetreMetreSteradian, "W/(m³⋅sr)", [(Watt, P1), (Metre, N3), (Steradian, N1)]; marked SpectralRadiance);
unit!(compound: WattPerSquareMetreNanometreSteradian, "W/(m²⋅nm⋅sr)", [(Watt, P1), (Metre, N2), (Nanometre, N1), (Steradian, N1)]; marked SpectralRadiance);

// ==============================================================================

#[cfg(test)]
mod tests {
    use super::*;
    use crate::common::verify_unit;

    // LUMINOUS FLUX
    verify_unit!(Lumen, LuminousFlux, 1.0);

    // LUMINANCE
    verify_unit!(Nit, Luminance, 1.0);

    // ILLUMINANCE
    verify_unit!(Lux, Illuminance, 1.0);
    verify_unit!(Kilolux, Illuminance, 1000.0);

    // OPTICAL POWER
    verify_unit!(Dioptre, OpticalPower, 1.0);

    // LUMINOUS ENERGY
    verify_unit!(LumenSecond, LuminousEnergy, 1.0);
    verify_unit!(Talbot, LuminousEnergy, 1.0);

    // LUMINOUS EXPOSURE
    verify_unit!(LuxSecond, LuminousExposure, 1.0);

    // LUMINOUS EFFICACY
    verify_unit!(LumenPerWatt, LuminousEfficacy, 1.0);

    // RADIANCE
    verify_unit!(WattPerSquareMetreSteradian, Radiance, 1.0);

    // RADIANT INTENSITY
    verify_unit!(WattPerSteradian, RadiantIntensity, 1.0);

    // IRRADIANCE
    verify_unit!(WattPerSquareMetre, Irradiance, 1.0);

    // SPECTRAL RADIANCE
    verify_unit!(WattPerSquareMetreMetreSteradian, SpectralRadiance, 1.0);
    verify_unit!(WattPerSquareMetreNanometreSteradian, SpectralRadiance, 1e9);
}