salva2d 0.9.0

2-dimensional particle-based fluid dynamics in Rust.
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

use crate::counters::Counters;
use crate::geometry::{self, HGrid, HGridEntry, ParticlesContacts};
use crate::math::Real;
use crate::object::Boundary;
use crate::object::Fluid;

/// Structure responsible for computing and grouping all the contact between fluid and boundary particles.
pub struct ContactManager {
    /// All contacts detected between pairs of fluid partices.
    pub fluid_fluid_contacts: Vec<ParticlesContacts>,
    /// All contacts detected between a fluid particle and a boundary particle.
    pub fluid_boundary_contacts: Vec<ParticlesContacts>,
    /// All contacts detected between two boundary particles.
    pub boundary_boundary_contacts: Vec<ParticlesContacts>,
}

impl ContactManager {
    /// Create a new contact manager.
    pub fn new() -> Self {
        Self {
            fluid_fluid_contacts: Vec::new(),
            fluid_boundary_contacts: Vec::new(),
            boundary_boundary_contacts: Vec::new(),
        }
    }

    /// The total number of contacts detected by this manager.
    ///
    /// Note that there will be two contact for each pair of distinct particles.
    pub fn ncontacts(&self) -> usize {
        self.fluid_fluid_contacts
            .iter()
            .map(|c| c.len())
            .sum::<usize>()
            + self
                .fluid_boundary_contacts
                .iter()
                .map(|c| c.len())
                .sum::<usize>()
            + self
                .boundary_boundary_contacts
                .iter()
                .map(|c| c.len())
                .sum::<usize>()
    }

    /// Computes all the contacts between the particles inserted on the provided spacial grid.
    pub fn update_contacts(
        &mut self,
        counters: &mut Counters,
        h: Real,
        fluids: &[Fluid],
        boundaries: &[Boundary],
        hgrid: &HGrid<HGridEntry>,
    ) {
        geometry::compute_contacts(
            counters,
            h,
            &fluids,
            &boundaries,
            &mut self.fluid_fluid_contacts,
            &mut self.fluid_boundary_contacts,
            &mut self.boundary_boundary_contacts,
            hgrid,
        );
    }
}