honeycomb-kernels 0.11.0

Meshing kernel implementations using combinatorial maps
Documentation
//! Step 5 implementation
//
//! Use the information computed at step 4 and insert all new edges into the map.

use honeycomb_core::cmap::{CMap2, DartIdType};
use honeycomb_core::geometry::CoordsFloat;
use honeycomb_core::stm::atomically_with_err;

use crate::cell_insertion::insert_vertices_on_edge;
use crate::grisubal::model::{Boundary, MapEdge};
use crate::utils::VertexAnchor;

#[allow(clippy::cast_possible_truncation)]
pub(crate) fn insert_edges_in_map<T: CoordsFloat>(cmap: &mut CMap2<T>, edges: &[MapEdge<T>]) {
    let dart_slices = build_workload(cmap, edges);

    for (
        i,
        (
            MapEdge {
                start,
                intermediates,
                end,
            },
            dslice,
        ),
    ) in edges.iter().zip(dart_slices.iter()).enumerate()
    {
        let &[d_new, b2_d_new] = &dslice[0..2] else {
            unreachable!()
        };
        build_base_edge(cmap, *start, *end, [d_new, b2_d_new]);

        if !intermediates.is_empty() {
            // create the topology components
            let edge_id = cmap.edge_id(d_new);
            let new_darts = &dslice[2..];
            atomically_with_err(|t| {
                insert_vertices_on_edge(
                    cmap,
                    t,
                    edge_id,
                    new_darts,
                    &vec![T::from(0.5).unwrap(); intermediates.len()],
                )
            })
            .unwrap();
            // replace placeholder vertices
            let mut dart_id = cmap.beta::<1>(edge_id as DartIdType);
            for v in intermediates {
                let vid = cmap.vertex_id(dart_id);
                let _ = cmap.write_vertex(vid, *v);
                if cmap.contains_attribute::<VertexAnchor>() {
                    let _ = cmap.write_attribute::<VertexAnchor>(vid, VertexAnchor::Node(i as u32));
                }
                dart_id = cmap.beta::<1>(dart_id);
            }
        }

        mark_boundary(cmap, *start, *end);
    }
}

#[allow(clippy::cast_possible_truncation)]
fn build_workload<T: CoordsFloat>(
    cmap: &mut CMap2<T>,
    edges: &[MapEdge<T>],
) -> Vec<Vec<DartIdType>> {
    // allocate all darts needed
    let n_tot: usize = edges.iter().map(|e| 2 + 2 * e.intermediates.len()).sum();
    let tmp = cmap.allocate_used_darts(n_tot) as usize;

    // the prefix sum gives an offset that corresponds to the starting index of each slice, minus
    // the location of the allocated dart block (given by `tmp`)
    // we can deduce theend of the slice from start index (prefix sum) + number of darts
    edges
        .iter()
        .map(|e| 2 + 2 * e.intermediates.len())
        .scan(0, |state, n_d| {
            *state += n_d;
            Some((n_d, *state - n_d)) // we want an offset, not the actual sum
        })
        .map(|(n_d, start)| {
            ((tmp + start) as DartIdType..(tmp + start + n_d) as DartIdType).collect::<Vec<_>>()
        })
        .collect()
}

fn build_base_edge<T: CoordsFloat>(
    cmap: &CMap2<T>,
    start: DartIdType,
    end: DartIdType,
    [d_new, b2_d_new]: [DartIdType; 2],
) {
    // remove deprecated connectivities & save what data is necessary
    let b1_start_old = cmap.beta::<1>(start);
    let b0_end_old = cmap.beta::<0>(end);
    cmap.unlink::<1>(start).unwrap();
    cmap.unlink::<1>(b0_end_old).unwrap();

    cmap.link::<2>(d_new, b2_d_new).unwrap();

    // rebuild - this is the final construct if there are no intermediates
    cmap.link::<1>(start, d_new).unwrap();
    cmap.link::<1>(b2_d_new, b1_start_old).unwrap();
    cmap.link::<1>(d_new, end).unwrap();
    cmap.link::<1>(b0_end_old, b2_d_new).unwrap();
}

fn mark_boundary<T: CoordsFloat>(cmap: &CMap2<T>, start: DartIdType, end: DartIdType) {
    let mut d_boundary = cmap.beta::<1>(start);
    while d_boundary != end {
        cmap.write_attribute::<Boundary>(d_boundary, Boundary::Left);
        cmap.write_attribute::<Boundary>(cmap.beta::<2>(d_boundary), Boundary::Right);
        d_boundary = cmap.beta::<1>(d_boundary);
    }
}