stormbird 0.9.0

A library for modeling modern wind propulsion devices
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

// Copyright (C) 2024, NTNU
// Author: Jarle Vinje Kramer <jarlekramer@gmail.com; jarle.a.kramer@ntnu.no>
// License: GPL v3.0 (see separate file LICENSE or https://www.gnu.org/licenses/gpl-3.0.html)

//! Models of two dimensional lift and drag on wing sections, such as foil profiles and rotating 
//! cylinders. 

/// Section model of a foil profile
pub mod foil;
/// Section model of a foil profile where the parameters can vary depending on an internal state
pub mod varying_foil;
/// Section model of a rotating cylinder, for instance to be used when modelling rotor sails.
pub mod rotating_cylinder;

use serde::{Serialize, Deserialize};
use stormath::type_aliases::Float;

use foil::Foil;
use varying_foil::VaryingFoil;
use rotating_cylinder::RotatingCylinder;

#[derive(Debug, Clone, Serialize, Deserialize)]
/// Sectional model for a wing, that can be of multiple variants
pub enum SectionModel {
    Foil(Foil),
    VaryingFoil(VaryingFoil),
    RotatingCylinder(RotatingCylinder),
    EffectiveWindSensor,
}

impl SectionModel {
    pub fn amount_of_flow_separation(&self, angle_of_attack: Float) -> Float {
        match self {
            SectionModel::Foil(foil) => foil.amount_of_stall(angle_of_attack),
            SectionModel::VaryingFoil(varying_foil) => varying_foil.amount_of_stall(angle_of_attack),
            SectionModel::RotatingCylinder(_) => 1.0,
            SectionModel::EffectiveWindSensor => 0.0
        }
    }

    pub fn from_string(setup_string: &str) -> Result<Self, String> {
        let section_model: SectionModel = serde_json::from_str(setup_string)
            .map_err(|e| format!("Failed to parse section model from string: {}", e))?;
        
        Ok(section_model)
    }

    pub fn to_string(&self) -> String {
        serde_json::to_string(self).unwrap()
    }
}

impl Default for SectionModel {
    fn default() -> Self {
        SectionModel::Foil(Foil::default())
    }
}

#[cfg(test)]
mod tests;