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
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

// 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)

use stormath::interpolation::linear_interpolation;

use super::*;

#[derive(Debug, Clone, Serialize, Deserialize)]
/// A foil profile where the parameters can vary depending on an internal state. 
/// 
/// The two typical use cases are to model foil sections that include a flap angle, or suction 
/// sails, where the foil section properties are dependent on the suction rate.
pub struct VaryingFoil {
    pub internal_state_data: Vec<Float>,
    pub foils_data: Vec<Foil>,
    #[serde(default)]
    pub current_internal_state: Float,
    #[serde(default)]
    pub current_foil: Option<Foil>,
}

impl VaryingFoil {
    pub fn new_from_string(input_str: &str) -> Self {
        let data: VaryingFoil = serde_json::from_str(input_str).unwrap();
        
        data
    }

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

    pub fn get_foil(&self) -> Foil {
        let cl_zero_angle_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_zero_angle).collect();
        let cl_initial_slope_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_initial_slope).collect();
        let cl_high_order_factor_positive_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_high_order_factor_positive).collect();
        let cl_high_order_factor_negative_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_high_order_factor_negative).collect();
        let cl_high_order_power_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_high_order_power).collect();
        let cl_max_after_stall_data: Vec<Float> = self.foils_data.iter().map(|x| x.cl_max_after_stall).collect();

        let cd_min_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_min).collect();
        let angle_cd_min_data: Vec<Float> = self.foils_data.iter().map(|x| x.angle_cd_min).collect();
        let cd_second_order_factor_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_second_order_factor).collect();
        let cd_max_after_stall_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_max_after_stall).collect();
        let cd_power_after_stall_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_power_after_stall).collect();
        let cdi_correction_factor_data: Vec<Float> = self.foils_data.iter().map(|x| x.cdi_correction_factor).collect();

        let mean_positive_stall_angle_data: Vec<Float> = self.foils_data.iter().map(|x| x.mean_positive_stall_angle).collect();
        let mean_negative_stall_angle_data: Vec<Float> = self.foils_data.iter().map(|x| x.mean_negative_stall_angle).collect();
        let stall_range_data: Vec<Float> = self.foils_data.iter().map(|x| x.stall_range).collect();
        let cd_stall_angle_offset_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_stall_angle_offset).collect();
        let cd_bump_during_stall_data: Vec<Float> = self.foils_data.iter().map(|x| x.cd_bump_during_stall).collect();

        let added_mass_factor_data: Vec<Float> = self.foils_data.iter().map(|x| x.added_mass_factor).collect();

        let x = self.current_internal_state;
        let x_data = &self.internal_state_data;

        Foil {
            cl_zero_angle:             linear_interpolation(x, x_data, &cl_zero_angle_data),
            cl_initial_slope:          linear_interpolation(x, x_data, &cl_initial_slope_data),
            cl_high_order_factor_positive: linear_interpolation(x, x_data, &cl_high_order_factor_positive_data),
            cl_high_order_factor_negative: linear_interpolation(x, x_data, &cl_high_order_factor_negative_data),
            cl_high_order_power:       linear_interpolation(x, x_data, &cl_high_order_power_data),
            cl_max_after_stall:        linear_interpolation(x, x_data, &cl_max_after_stall_data),
            cd_min:                    linear_interpolation(x, x_data, &cd_min_data),
            angle_cd_min:              linear_interpolation(x, x_data, &angle_cd_min_data),
            cd_second_order_factor:    linear_interpolation(x, x_data, &cd_second_order_factor_data),
            cd_max_after_stall:        linear_interpolation(x, x_data, &cd_max_after_stall_data),
            cd_power_after_stall:      linear_interpolation(x, x_data, &cd_power_after_stall_data),
            cdi_correction_factor:     linear_interpolation(x, x_data, &cdi_correction_factor_data),
            mean_positive_stall_angle: linear_interpolation(x, x_data, &mean_positive_stall_angle_data),
            mean_negative_stall_angle: linear_interpolation(x, x_data, &mean_negative_stall_angle_data),
            stall_range:               linear_interpolation(x, x_data, &stall_range_data),
            cd_stall_angle_offset:     linear_interpolation(x, x_data, &cd_stall_angle_offset_data),
            cd_bump_during_stall:      linear_interpolation(x, x_data, &cd_bump_during_stall_data),
            added_mass_factor:         linear_interpolation(x, x_data, &added_mass_factor_data)
        }
    }

    pub fn set_internal_state(&mut self, internal_state: Float) {
        self.current_internal_state = internal_state;
        self.current_foil = Some(self.get_foil());
    }

    pub fn lift_coefficient(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient(angle_of_attack)
    }

    pub fn lift_coefficient_linear(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient_linear(angle_of_attack)
    }

    pub fn lift_coefficient_pre_stall_raw(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient_pre_stall_raw(angle_of_attack)
    }

    pub fn lift_coefficient_pre_stall_with_stall_drop_off(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient_pre_stall_with_stall_drop_off(angle_of_attack)
    }

    pub fn lift_coefficient_post_stall_raw(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient_post_stall_raw(angle_of_attack)
    }

    pub fn lift_coefficient_post_stall_with_stall_weight(&self, angle_of_attack: Float) -> Float {
        self.get_foil().lift_coefficient_post_stall_with_stall_weight(angle_of_attack)
    }

    pub fn drag_coefficient(&self, angle_of_attack: Float) -> Float {
        self.get_foil().drag_coefficient(angle_of_attack)
    }

    pub fn added_mass_coefficient(&self, heave_acceleration: Float) -> Float {
        self.get_foil().added_mass_coefficient(heave_acceleration)
    }

    pub fn amount_of_stall(&self, angle_of_attack: Float) -> Float {
        self.get_foil().amount_of_stall(angle_of_attack)
    }
}