Module i2pp.core.interpolate_element_data

Interpolate image data to FEM-Elements.

Functions

def interpolate_image_to_discretization(dis: Discretization,
image_data: ImageData,
interpolation_method: str) ‑> list[Element]

Expand source code

def interpolate_image_to_discretization(
    dis: Discretization, image_data: ImageData, interpolation_method: str
) -> list[Element]:
    """Performs interpolation of image data onto the FEM Discretization based
    on the specified interpolation method.

    This function applies different interpolation methods depending on the
    user configuration. The pixel values are assigned to the FEM elements
    using one of the following approaches:

    - "nodes": Computes the mean pixel value for each element based on its
        node values.
    - "allvoxels": Computes the mean pixel value for each element based on
        all voxels inside it.
    - "elementcenter": Assigns pixel values based on the center of each
        element.

    Arguments:
        dis (Discretization): The Discretization object containing FEM
            elements and node coordinates.
        image_data (ImageData): A structured representation containing 3D
            pixel data, grid coordinates, orientation, and metadata.
        interpolation_method (str): The type of interpolation to perform for
            assigning pixel values to the elements. This should match one of
            the `InterpolationType` enum values (e.g., "nodes",
            "elementcenter", "allvoxels").

    Returns:
        list[Element]: A list of FEM elements with interpolated pixel data.
    """

    enum_interpolation_method = InterpolationType(interpolation_method)

    interpolator = enum_interpolation_method.get_interpolator()()

    return interpolator.compute_element_data(dis, image_data)

Performs interpolation of image data onto the FEM Discretization based on the specified interpolation method.

This function applies different interpolation methods depending on the user configuration. The pixel values are assigned to the FEM elements using one of the following approaches:

• "nodes": Computes the mean pixel value for each element based on its node values.
• "allvoxels": Computes the mean pixel value for each element based on all voxels inside it.
• "elementcenter": Assigns pixel values based on the center of each element.

Arguments

dis (Discretization): The Discretization object containing FEM elements and node coordinates. image_data (ImageData): A structured representation containing 3D pixel data, grid coordinates, orientation, and metadata. interpolation_method (str): The type of interpolation to perform for assigning pixel values to the elements. This should match one of the InterpolationType enum values (e.g., "nodes", "elementcenter", "allvoxels").

Returns

list[Element]

A list of FEM elements with interpolated pixel data.