cfsem 8.2.0

Quasi-steady electromagnetics including filamentized approximations, Biot-Savart, and Grad-Shafranov.
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

//! Family-specific quadrilateral sampling and metadata for the structural 2D FEM backend.

use crate::mesh::elements::quad2d::{quad4, quad9};
use crate::mesh::quad2d::{Quad4ReferenceElement, Quad9ReferenceElement, QuadReferenceElement};
use crate::mesh::{QuadratureRule, sampling};
use crate::physics::solenoid_stress::geometry::{FaceSample, VolumeSample};
use crate::physics::solenoid_stress::model::Structural2dElementType;
use crate::physics::solenoid_stress::types::Real;

/// Family-specific differences that remain after stiffness, load, and recovery assembly have been
/// written once generically.
///
/// This trait owns only:
/// - element-type metadata exposed through the public model,
/// - family-specific volume sampling,
/// - family-specific face sampling, and
/// - connectivity flattening for Python-facing metadata export.
pub(crate) trait QuadElementFamily<const NODES_PER_ELEMENT: usize> {
    /// Reference-element implementation used by mesh query and recovery operators.
    type ReferenceElement: QuadReferenceElement<NODES_PER_ELEMENT>;

    /// Return the public element-family tag corresponding to this internal family marker.
    fn element_type() -> Structural2dElementType;

    /// Flatten element connectivity into one element-major `Vec<usize>` for metadata export.
    fn flatten_elements(elements: &[[usize; NODES_PER_ELEMENT]]) -> Vec<usize> {
        let mut flat = Vec::with_capacity(elements.len() * NODES_PER_ELEMENT);
        for conn in elements {
            flat.extend_from_slice(conn);
        }
        flat
    }

    /// Evaluate the family-specific volume quadrature samples for one element.
    fn volume_samples<F: Real>(
        coords: &[[F; 2]; NODES_PER_ELEMENT],
        quadrature: QuadratureRule,
    ) -> Result<Vec<VolumeSample<F, NODES_PER_ELEMENT>>, String>;

    /// Evaluate the family-specific face quadrature samples for one element face.
    fn face_samples<F: Real>(
        coords: &[[F; 2]; NODES_PER_ELEMENT],
        local_face: u8,
        quadrature: QuadratureRule,
    ) -> Result<Vec<FaceSample<F, NODES_PER_ELEMENT>>, String>;
}

/// Marker type for the bilinear four-node quadrilateral family.
pub(crate) struct Quad4Family;

impl QuadElementFamily<{ quad4::NODES_PER_ELEMENT }> for Quad4Family {
    type ReferenceElement = Quad4ReferenceElement;

    /// Identify this marker as the public `quad4` family.
    fn element_type() -> Structural2dElementType {
        Structural2dElementType::Quad4
    }

    /// Delegate `quad4` volume sampling to the generic mesh sampling layer.
    fn volume_samples<F: Real>(
        coords: &[[F; 2]; quad4::NODES_PER_ELEMENT],
        quadrature: QuadratureRule,
    ) -> Result<Vec<VolumeSample<F, { quad4::NODES_PER_ELEMENT }>>, String> {
        sampling::volume_samples_quad4(coords, quadrature)
    }

    /// Delegate `quad4` face sampling to the generic mesh sampling layer.
    fn face_samples<F: Real>(
        coords: &[[F; 2]; quad4::NODES_PER_ELEMENT],
        local_face: u8,
        quadrature: QuadratureRule,
    ) -> Result<Vec<FaceSample<F, { quad4::NODES_PER_ELEMENT }>>, String> {
        sampling::face_samples_quad4(coords, local_face, quadrature)
    }
}

/// Marker type for the quadratic nine-node quadrilateral family.
pub(crate) struct Quad9Family;

impl QuadElementFamily<{ quad9::NODES_PER_ELEMENT }> for Quad9Family {
    type ReferenceElement = Quad9ReferenceElement;

    /// Identify this marker as the public `quad9` family.
    fn element_type() -> Structural2dElementType {
        Structural2dElementType::Quad9
    }

    /// Delegate `quad9` volume sampling to the generic mesh sampling layer.
    fn volume_samples<F: Real>(
        coords: &[[F; 2]; quad9::NODES_PER_ELEMENT],
        quadrature: QuadratureRule,
    ) -> Result<Vec<VolumeSample<F, { quad9::NODES_PER_ELEMENT }>>, String> {
        sampling::volume_samples_quad9(coords, quadrature)
    }

    /// Delegate `quad9` face sampling to the generic mesh sampling layer.
    fn face_samples<F: Real>(
        coords: &[[F; 2]; quad9::NODES_PER_ELEMENT],
        local_face: u8,
        quadrature: QuadratureRule,
    ) -> Result<Vec<FaceSample<F, { quad9::NODES_PER_ELEMENT }>>, String> {
        sampling::face_samples_quad9(coords, local_face, quadrature)
    }
}