uom/si/
electric_field.rs

1//! Electric field (base unit volt per meter, m ⋅ kg ⋅ s⁻³ ⋅ A⁻¹).
2
3quantity! {
4    /// Electric field (base unit volt per meter, m ⋅ kg ⋅ s⁻³ ⋅ A⁻¹).
5    quantity: ElectricField; "electric field";
6    /// Dimension of electric field, LMT⁻³I⁻¹ (base unit volt per meter, m ⋅ kg ⋅ s⁻³ ⋅ A⁻¹).
7    dimension: ISQ<
8        P1,     // length
9        P1,     // mass
10        N3,     // time
11        N1,     // electric current
12        Z0,     // thermodynamic temperature
13        Z0,     // amount of substance
14        Z0>;    // luminous intensity
15    units {
16        @volt_per_meter: prefix!(none); "V/m", "volt per meter", "volts per meter";
17        @volt_per_centimeter: prefix!(none) / prefix!(centi); "V/cm", "volt per centimeter",
18            "volts per centimeter";
19        @volt_per_millimeter: prefix!(none) / prefix!(milli); "V/mm", "volt per millimeter",
20            "volts per millimeter";
21        @volt_per_micrometer: prefix!(none) / prefix!(micro); "V/μm", "volt per micrometer",
22            "volts per micrometer";
23        @kilovolt_per_millimeter: prefix!(kilo) / prefix!(milli); "kV/mm",
24            "kilovolt per millimeter", "kilovolts per millimeter";
25        @megavolt_per_meter: prefix!(mega); "MV/m", "megavolt per meter", "megavolts per meter";
26        @megavolt_per_centimeter: prefix!(mega) / prefix!(centi); "MV/cm",
27            "megavolt per centimeter", "megavolts per centimeter";
28        @volt_per_mil: prefix!(none) / 2.54_E-5; "V/mil", "volt per mil", "volts per mil";
29
30        /// Hartree atomic unit of electric field Eₕ / (e ⋅ a₀), where Eₕ is Hartree energy, e is
31        /// elementary charge, and a₀ is Bohr radius.
32        @atomic_unit_of_electric_field: 5.142_206_747_632_595_E11; "a.u. of electric field",
33            "atomic unit of electric field", "atomic units of electric field";
34    }
35}
36
37#[cfg(test)]
38mod test {
39    storage_types! {
40        use crate::num::One;
41        use crate::si::electric_field as ef;
42        use crate::si::quantities::*;
43        use crate::si::electric_potential as ep;
44        use crate::si::energy as en;
45        use crate::si::electric_charge as ec;
46        use crate::si::length as l;
47        use crate::tests::Test;
48
49        #[test]
50        fn check_dimension() {
51            let _: ElectricField<V> = ElectricPotential::new::<ep::volt>(V::one())
52                / Length::new::<l::meter>(V::one());
53        }
54
55        #[test]
56        fn check_units() {
57            test::<ep::volt, l::meter, ef::volt_per_meter>();
58            test::<ep::volt, l::centimeter, ef::volt_per_centimeter>();
59            test::<ep::volt, l::millimeter, ef::volt_per_millimeter>();
60            test::<ep::volt, l::micrometer, ef::volt_per_micrometer>();
61            test::<ep::kilovolt, l::millimeter, ef::kilovolt_per_millimeter>();
62            test::<ep::megavolt, l::centimeter, ef::megavolt_per_centimeter>();
63            test::<ep::megavolt, l::meter, ef::megavolt_per_meter>();
64            test::<ep::volt, l::mil, ef::volt_per_mil>();
65
66            fn test<EP: ep::Conversion<V>, L: l::Conversion<V>, EF: ef::Conversion<V>>() {
67                Test::assert_approx_eq(&ElectricField::new::<EF>(V::one()),
68                    &(ElectricPotential::new::<EP>(V::one())
69                        / Length::new::<L>(V::one())));
70            }
71        }
72
73        #[test]
74        fn check_units_eql() {
75            test::<en::joule, ec::coulomb, l::meter, ef::volt_per_meter>();
76            test::<en::hartree, ec::elementary_charge, l::bohr_radius,
77                ef::atomic_unit_of_electric_field>();
78
79            fn test<EN: en::Conversion<V>, Q: ec::Conversion<V>, L: l::Conversion<V>,
80                EF: ef::Conversion<V>>()
81            {
82                Test::assert_approx_eq(&ElectricField::new::<EF>(V::one()),
83                    &(Energy::new::<EN>(V::one())
84                        / ElectricCharge::new::<Q>(V::one())
85                        / Length::new::<L>(V::one())));
86            }
87        }
88    }
89}