mesh-sieve 4.0.1

Modular, high-performance Rust library for mesh and data management, designed for scientific computing and PDE codes.
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

//! Reference-based extensions for `Sieve` to avoid cloning payloads during traversal.
//!
//! This trait is additive: existing code using `Sieve` keeps working.
//! Algorithms that want zero-clone traversal can require `SieveRef`.

use super::sieve_trait::Sieve;

pub trait SieveRef: Sieve {
    /// Iterator over (dst, &payload) without cloning.
    type ConeRefIter<'a>: Iterator<Item = (Self::Point, &'a Self::Payload)>
    where
        Self: 'a;

    /// Iterator over (src, &payload) without cloning.
    type SupportRefIter<'a>: Iterator<Item = (Self::Point, &'a Self::Payload)>
    where
        Self: 'a;

    /// Borrowing cone.
    fn cone_ref<'a>(&'a self, p: Self::Point) -> Self::ConeRefIter<'a>;

    /// Borrowing support.
    fn support_ref<'a>(&'a self, p: Self::Point) -> Self::SupportRefIter<'a>;

    /// Point-only adapters (never touch payloads).
    #[inline]
    fn cone_points<'a>(&'a self, p: Self::Point) -> impl Iterator<Item = Self::Point> + 'a {
        self.cone_ref(p).map(|(q, _)| q)
    }

    #[inline]
    fn support_points<'a>(&'a self, p: Self::Point) -> impl Iterator<Item = Self::Point> + 'a {
        self.support_ref(p).map(|(q, _)| q)
    }
}