Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Thermal conductance #408

Merged
merged 1 commit into from
Feb 10, 2023
Merged

Thermal conductance #408

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/si/mod.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,7 @@ system! {
temperature_coefficient::TemperatureCoefficient,
temperature_gradient::TemperatureGradient,
temperature_interval::TemperatureInterval,
thermal_conductance::ThermalConductance,
thermal_conductivity::ThermalConductivity,
thermodynamic_temperature::ThermodynamicTemperature,
time::Time,
Expand Down
240 changes: 240 additions & 0 deletions src/si/thermal_conductance.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,240 @@
//! Thermal conductance (base unit watt per kelvin, kg · m² · s⁻³ · K⁻¹).
//!
//! Thermal conductance has the same kind as [temperature interval][ti], as this quantity relates
//! to change of temperature. Not of kind `TemperatureKind`, used by [thermodynamic
//! temperature][tt]. See [thermodynamic temperature][tt] for a full explanation.
//!
//! [ti]: ../temperature_interval/index.html
//! [tt]: ../thermodynamic_temperature/index.html

quantity! {
/// Thermal conductance (base unit watt per kelvin, kg · m² · s⁻³ · K⁻¹).
quantity: ThermalConductance; "thermal conductance";
/// Dimension of thermal conductance, LM²T⁻³Th⁻¹ (base unit watt per kelvin, kg · m² · s⁻³
/// · K⁻¹).
dimension: ISQ<
P2, // length
P1, // mass
N3, // time
Z0, // electric current
N1, // thermodynamic temperature
Z0, // amount of substance
Z0>; // luminous intensity
units {
@yottagram_meter_per_second_cubed_kelvin: prefix!(yotta) / prefix!(kilo);
"Yg · m²/(s³ · K)", "yottagram meter squared per second cubed kelvin",
"yottagrams meter squared per second cubed kelvin";
@zettagram_meter_per_second_cubed_kelvin: prefix!(zetta) / prefix!(kilo);
"Zg · m²/(s³ · K)", "zettagram meter squared per second cubed kelvin",
"zettagrams meter squared per second cubed kelvin";
@exagram_meter_per_second_cubed_kelvin: prefix!(exa) / prefix!(kilo); "Eg · m²/(s³ · K)",
"exagram meter squared per second cubed kelvin",
"exagrams meter squared per second cubed kelvin";
@petagram_meter_per_second_cubed_kelvin: prefix!(peta) / prefix!(kilo); "Pg · m²/(s³ · K)",
"petagram meter squared per second cubed kelvin",
"petagrams meter squared per second cubed kelvin";
@teragram_meter_per_second_cubed_kelvin: prefix!(tera) / prefix!(kilo); "Tg · m²/(s³ · K)",
"teragram meter squared per second cubed kelvin",
"teragrams meter squared per second cubed kelvin";
@gigagram_meter_per_second_cubed_kelvin: prefix!(giga) / prefix!(kilo); "Gg · m²/(s³ · K)",
"gigagram meter squared per second cubed kelvin",
"gigagrams meter squared per second cubed kelvin";
@megagram_meter_per_second_cubed_kelvin: prefix!(mega) / prefix!(kilo); "Mg · m²/(s³ · K)",
"megagram meter squared per second cubed kelvin",
"megagrams meter squared per second cubed kelvin";
/// Derived unit of thermal conductance in base units. Equivalent to W/K.
@kilogram_meter_per_second_cubed_kelvin: prefix!(kilo) / prefix!(kilo); "kg · m²/(s³ · K)",
"kilogram meter squared per second cubed kelvin",
"kilograms meter squared per second cubed kelvin";
@hectogram_meter_per_second_cubed_kelvin: prefix!(hecto) / prefix!(kilo);
"hg · m²/(s³ · K)", "hectogram meter squared per second cubed kelvin",
"hectograms meter squared per second cubed kelvin";
@decagram_meter_per_second_cubed_kelvin: prefix!(deca) / prefix!(kilo); "dag · m²/(s³ · K)",
"decagram meter squared per second cubed kelvin",
"decagrams meter squared per second cubed kelvin";
@gram_meter_per_second_cubed_kelvin: prefix!(none) / prefix!(kilo); "g · m/(s³ · K)",
"gram meter per second cubed kelvin", "grams meter per second cubed kelvin";
@decigram_meter_per_second_cubed_kelvin: prefix!(deci) / prefix!(kilo); "dg · m²/(s³ · K)",
"decigram meter squared per second cubed kelvin",
"decigrams meter squared per second cubed kelvin";
@centigram_meter_per_second_cubed_kelvin: prefix!(centi) / prefix!(kilo);
"cg · m²/(s³ · K)", "centigram meter squared per second cubed kelvin",
"centigrams meter squared per second cubed kelvin";
@milligram_meter_per_second_cubed_kelvin: prefix!(milli) / prefix!(kilo);
"mg · m²/(s³ · K)", "milligram meter squared per second cubed kelvin",
"milligrams meter squared per second cubed kelvin";
@microgram_meter_per_second_cubed_kelvin: prefix!(micro) / prefix!(kilo); "µg · m/(s³ · K)",
"microgram meter squared per second cubed kelvin",
"micrograms meter squared per second cubed kelvin";
@nanogram_meter_per_second_cubed_kelvin: prefix!(nano) / prefix!(kilo); "ng · m²/(s³ · K)",
"nanogram meter squared per second cubed kelvin",
"nanograms meter squared per second cubed kelvin";
@picogram_meter_per_second_cubed_kelvin: prefix!(pico) / prefix!(kilo); "pg · m²/(s³ · K)",
"picogram meter squared per second cubed kelvin",
"picograms meter squared per second cubed kelvin";
@femtogram_meter_per_second_cubed_kelvin: prefix!(femto) / prefix!(kilo);
"fg · m²/(s³ · K)", "femtogram meter squared per second cubed kelvin",
"femtograms meter squared per second cubed kelvin";
@attogram_meter_per_second_cubed_kelvin: prefix!(atto) / prefix!(kilo); "ag · m²/(s³ · K)",
"attogram meter squared per second cubed kelvin",
"attograms meter squared per second cubed kelvin";
@zeptogram_meter_per_second_cubed_kelvin: prefix!(zepto) / prefix!(kilo);
"zg · m²/(s³ · K)", "zeptogram meter squared per second cubed kelvin",
"zeptograms meter squared per second cubed kelvin";
@yoctogram_meter_per_second_cubed_kelvin: prefix!(yocto) / prefix!(kilo);
"yg · m²/(s³ · K)", "yoctogram meter squared per second cubed kelvin",
"yoctograms meter squared per second cubed kelvin";

// Thermal conductance is much more commonly expressed in terms of power / temperature.
@yottawatt_per_kelvin: prefix!(yotta); "YW/K", "yottawatt per kelvin",
"yottawatts per kelvin";
@zettawatt_per_kelvin: prefix!(zetta); "ZW/K", "zettawatt per kelvin",
"zettawatts per kelvin";
@exawatt_per_kelvin: prefix!(exa); "EW/K", "exawatt per kelvin", "exawatts per kelvin";
@petawatt_per_kelvin: prefix!(peta); "PW/K", "petawatt per kelvin", "petawatts per kelvin";
@terawatt_per_kelvin: prefix!(tera); "TW/K", "terawatt per kelvin", "terawatts per kelvin";
@gigawatt_per_kelvin: prefix!(giga); "GW/K", "gigawatt per kelvin", "gigawatts per kelvin";
@megawatt_per_kelvin: prefix!(mega); "MW/K", "megawatt per kelvin", "megawatts per kelvin";
@kilowatt_per_kelvin: prefix!(kilo); "kW/K", "kilowatt per kelvin", "kilowatts per kelvin";
@hectowatt_per_kelvin: prefix!(hecto); "hW/K", "hectowatt per kelvin",
"hectowatts per kelvin";
@decawatt_per_kelvin: prefix!(deca); "daW/K", "decawatt per kelvin", "decawatts per kelvin";
/// Derived unit of thermal conductance in derived units. Equivalent to kg · m²/(s³ · K).
@watt_per_kelvin: prefix!(none); "W/K", "watt per kelvin", "watts per kelvin";
@deciwatt_per_kelvin: prefix!(deci); "dW/K", "deciwatt per kelvin", "deciwatts per kelvin";
@centiwatt_per_kelvin: prefix!(centi); "cW/K", "centiwatt per kelvin",
"centiwatts per kelvin";
@milliwatt_per_kelvin: prefix!(milli); "mW/K", "milliwatt per kelvin",
"milliwatts per kelvin";
@microwatt_per_kelvin: prefix!(micro); "µW/K", "microwatt per kelvin",
"microwatts per kelvin";
@nanowatt_per_kelvin: prefix!(nano); "nW/K", "nanowatt per kelvin", "nanowatts per kelvin";
@picowatt_per_kelvin: prefix!(pico); "pW/K", "picowatt per kelvin", "picowatts per kelvin";
@femtowatt_per_kelvin: prefix!(femto); "fW/K", "femtowatt per kelvin",
"femtowatts per kelvin";
@attowatt_per_kelvin: prefix!(atto); "aW/K", "attowatt per kelvin", "attowatts per kelvin";
@zeptowatt_per_kelvin: prefix!(zepto); "zW/K", "zeptowatt per kelvin",
"zeptowatts per kelvin";
@yoctowatt_per_kelvin: prefix!(yocto); "yW/K", "yoctowatt per kelvin",
"yoctowatts per kelvin";

// Celsius for convenience.
@kilogram_meter_squared_per_second_cubed_degree_celsius: prefix!(kilo) / prefix!(kilo);
"kg · m²/(s³ · °C)", "kilogram meter squared per second cubed degree Celsius",
"kilograms meter squared per second cubed degree Celsius";
@kilowatt_per_degree_celsius: prefix!(kilo); "kW/°C", "kilowatt per degree Celsius",
"kilowatts per degree Celsius";
/// Derived unit of thermal conductance in derived units. Equivalent to kg · m²/(s³ · K).
@watt_per_meter_degree_celsius: prefix!(none); "W/°C", "watt per degree Celsius",
"watts per degree Celsius";
@milliwatt_per_degree_celsius: prefix!(milli); "mW/°C", "milliwatt per degree Celsius",
"milliwatts per degree Celsius";
}
}

#[cfg(test)]
mod tests {
storage_types! {
use crate::num::One;
use crate::si::length as l;
use crate::si::mass as m;
use crate::si::power as p;
use crate::si::quantities::*;
use crate::si::temperature_interval as ti;
use crate::si::thermal_conductance as tc;
use crate::si::time as t;
use crate::tests::Test;

#[test]
fn check_dimension() {
let _: ThermalConductance<V> = Mass::new::<m::kilogram>(V::one())
* Length::new::<l::meter>(V::one()) * Length::new::<l::meter>(V::one())
/ (Time::new::<t::second>(V::one())
* Time::new::<t::second>(V::one())
* Time::new::<t::second>(V::one())
* TemperatureInterval::new::<ti::kelvin>(V::one()));
}

#[test]
fn check_base_units() {
test::<m::yottagram, ti::kelvin, tc::yottagram_meter_per_second_cubed_kelvin>();
test::<m::zettagram, ti::kelvin, tc::zettagram_meter_per_second_cubed_kelvin>();
test::<m::exagram, ti::kelvin, tc::exagram_meter_per_second_cubed_kelvin>();
test::<m::petagram, ti::kelvin, tc::petagram_meter_per_second_cubed_kelvin>();
test::<m::teragram, ti::kelvin, tc::teragram_meter_per_second_cubed_kelvin>();
test::<m::gigagram, ti::kelvin, tc::gigagram_meter_per_second_cubed_kelvin>();
test::<m::megagram, ti::kelvin, tc::megagram_meter_per_second_cubed_kelvin>();
test::<m::kilogram, ti::kelvin, tc::kilogram_meter_per_second_cubed_kelvin>();
test::<m::hectogram, ti::kelvin, tc::hectogram_meter_per_second_cubed_kelvin>();
test::<m::decagram, ti::kelvin, tc::decagram_meter_per_second_cubed_kelvin>();
test::<m::gram, ti::kelvin, tc::gram_meter_per_second_cubed_kelvin>();
test::<m::decigram, ti::kelvin, tc::decigram_meter_per_second_cubed_kelvin>();
test::<m::centigram, ti::kelvin, tc::centigram_meter_per_second_cubed_kelvin>();
test::<m::milligram, ti::kelvin, tc::milligram_meter_per_second_cubed_kelvin>();
test::<m::microgram, ti::kelvin, tc::microgram_meter_per_second_cubed_kelvin>();
test::<m::nanogram, ti::kelvin, tc::nanogram_meter_per_second_cubed_kelvin>();
test::<m::picogram, ti::kelvin, tc::picogram_meter_per_second_cubed_kelvin>();
test::<m::femtogram, ti::kelvin, tc::femtogram_meter_per_second_cubed_kelvin>();
test::<m::attogram, ti::kelvin, tc::attogram_meter_per_second_cubed_kelvin>();
test::<m::zeptogram, ti::kelvin, tc::zeptogram_meter_per_second_cubed_kelvin>();
test::<m::yoctogram, ti::kelvin, tc::yoctogram_meter_per_second_cubed_kelvin>();

test::<m::kilogram, ti::degree_celsius,
tc::kilogram_meter_squared_per_second_cubed_degree_celsius>();

fn test<
M: m::Conversion<V>,
TI: ti::Conversion<V>,
TC: tc::Conversion<V>>()
{
Test::assert_approx_eq(&ThermalConductance::new::<TC>(V::one()),
&(Mass::new::<M>(V::one())
* Length::new::<l::meter>(V::one()) * Length::new::<l::meter>(V::one())
/ (Time::new::<t::second>(V::one())
* Time::new::<t::second>(V::one())
* Time::new::<t::second>(V::one())
* TemperatureInterval::new::<TI>(V::one()))));
}
}

#[test]
fn check_power_per_length_ti_units() {
test::<p::yottawatt, l::meter, ti::kelvin, tc::yottawatt_per_kelvin>();
test::<p::zettawatt, l::meter, ti::kelvin, tc::zettawatt_per_kelvin>();
test::<p::exawatt, l::meter, ti::kelvin, tc::exawatt_per_kelvin>();
test::<p::petawatt, l::meter, ti::kelvin, tc::petawatt_per_kelvin>();
test::<p::terawatt, l::meter, ti::kelvin, tc::terawatt_per_kelvin>();
test::<p::gigawatt, l::meter, ti::kelvin, tc::gigawatt_per_kelvin>();
test::<p::megawatt, l::meter, ti::kelvin, tc::megawatt_per_kelvin>();
test::<p::kilowatt, l::meter, ti::kelvin, tc::kilowatt_per_kelvin>();
test::<p::hectowatt, l::meter, ti::kelvin, tc::hectowatt_per_kelvin>();
test::<p::decawatt, l::meter, ti::kelvin, tc::decawatt_per_kelvin>();
test::<p::watt, l::meter, ti::kelvin, tc::watt_per_kelvin>();
test::<p::deciwatt, l::meter, ti::kelvin, tc::deciwatt_per_kelvin>();
test::<p::centiwatt, l::meter, ti::kelvin, tc::centiwatt_per_kelvin>();
test::<p::milliwatt, l::meter, ti::kelvin, tc::milliwatt_per_kelvin>();
test::<p::microwatt, l::meter, ti::kelvin, tc::microwatt_per_kelvin>();
test::<p::nanowatt, l::meter, ti::kelvin, tc::nanowatt_per_kelvin>();
test::<p::picowatt, l::meter, ti::kelvin, tc::picowatt_per_kelvin>();
test::<p::femtowatt, l::meter, ti::kelvin, tc::femtowatt_per_kelvin>();
test::<p::attowatt, l::meter, ti::kelvin, tc::attowatt_per_kelvin>();
test::<p::zeptowatt, l::meter, ti::kelvin, tc::zeptowatt_per_kelvin>();
test::<p::yoctowatt, l::meter, ti::kelvin, tc::yoctowatt_per_kelvin>();

test::<p::kilowatt, l::meter, ti::degree_celsius, tc::kilowatt_per_degree_celsius>();
test::<p::watt, l::meter, ti::degree_celsius, tc::watt_per_meter_degree_celsius>();
test::<p::milliwatt, l::meter, ti::degree_celsius, tc::milliwatt_per_degree_celsius>();

fn test<
P: p::Conversion<V>,
L: l::Conversion<V>,
TI: ti::Conversion<V>,
TC: tc::Conversion<V>>()
{
Test::assert_approx_eq(&ThermalConductance::new::<TC>(V::one()),
&(Power::new::<P>(V::one())
/ TemperatureInterval::new::<TI>(V::one())));
}
}
}
}