sciforge-core 0.0.4

Shared engineering primitives: materials, fasteners, fluids, propulsion taxonomies, std components.
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

use sciforge_hub::prelude::constants::physics::optics::laser_media;

#[derive(Debug, Clone, Copy)]
pub struct GainMedium {
    pub formula: &'static str,
}

impl GainMedium {
    pub fn new(formula: &'static str) -> Option<Self> {
        laser_media::by_formula(formula)?;
        Some(Self { formula })
    }

    pub fn wavelength_nm(&self) -> f64 {
        laser_media::by_formula(self.formula).map(|l| l.wavelength_nm).unwrap_or(0.0)
    }

    pub fn emission_cross_section_m2(&self) -> f64 {
        laser_media::by_formula(self.formula)
            .map(|l| l.emission_cross_section_m2)
            .unwrap_or(0.0)
    }

    pub fn upper_state_lifetime_s(&self) -> f64 {
        laser_media::by_formula(self.formula)
            .map(|l| l.upper_state_lifetime_s)
            .unwrap_or(0.0)
    }

    pub fn host(&self) -> &'static str {
        laser_media::by_formula(self.formula).map(|l| l.host).unwrap_or("")
    }

    pub fn saturation_intensity_w_per_m2(&self, wavelength_m: f64) -> f64 {
        let sigma = self.emission_cross_section_m2();
        let tau = self.upper_state_lifetime_s();
        let h = sciforge_hub::prelude::constants::H;
        let c = sciforge_hub::prelude::constants::C;
        if sigma == 0.0 || tau == 0.0 || wavelength_m == 0.0 {
            return 0.0;
        }
        h * c / (sigma * tau * wavelength_m)
    }

    pub fn small_signal_gain(&self, population_inversion_per_m3: f64, length_m: f64) -> f64 {
        self.emission_cross_section_m2() * population_inversion_per_m3 * length_m
    }
}