interpcore 1.0.0

Interpolator of different kind of loads and BC to APDL format

InterpCore

A Python library for interpolating physical field data (electromagnetic forces, heat flux, etc.) between different mesh representations and exporting to ANSYS APDL format.

Features

• Multiple interpolation kernels: Distance-weighted, FEM-based, K-nearest neighbors, closest point
• Flexible query methods: K-nearest neighbors or radius-based search
• Support for multiple load types:
  • EM forces (3-component vector fields)
  • Heat flux (scalar fields)
  • Heat generation (volumetric)
  • Heat Transfer Coefficient + bulk fluid temperature (convection BCs)
• Export to ANSYS APDL: Direct export of interpolated results in APDL format
• Visualization: Built-in VTK export for ParaView or PyVista visualization
• Efficient: KDTree-based spatial queries for fast neighbor searches

Installation

pip install interpcore

Quick Start

from interpcore.interpolator import Interpolator
from interpcore.config import InterpolationConfig, QUERY_TYPE, INTERPOLATED_LOAD_TYPE
from interpcore.kernels import INTERPOLATION_KERNEL

# Configure interpolation
config = InterpolationConfig(
    method=QUERY_TYPE.K,  # type of neighbour search
    param=5,  # parameter relative to the neighbour search (K or radius)
    max_distance=2.0, # filter by a max radius of search (in case of K is used)
    coincidence_tolerance=0.01, # tolerance to consider two nodes coincident
    kernel=INTERPOLATION_KERNEL.DISTANCE_WEIGHTED, # How to interpolate
    multithread=False, # use or not multithread
    interpolated_load=INTERPOLATED_LOAD_TYPE.EM_FORCE # type of load that is being interpolated
)

# Define file column indices. This gives the column index in the input files
file_idx = {"ids": 0, "dest_x": 1, "src_x": 1, "val": 4}

# Create interpolator and run
interpolator = Interpolator(
    path_to_src_folder="source_data",
    path_to_dest_mesh="destination_mesh.txt",
    config=config,
    file_idx=file_idx
)

# Interpolate all source files
interpolator.interpolate_all()

# Export to ANSYS format
interpolator.export_to_ansys("output_directory")

# Optional: Build VTK for visualization. If outdir=None they are not exported
interpolator.build_vtk_output(outdir="vtk_output")

Examples

Complete working examples with sample data are available in the doc/ folder:

• Heat Flux Example: Scalar field interpolation using the AVERAGE kernel
• Heat Generation Example: Volumetric heat generation using the CLOSEST kernel
• EM Force Example: Vector field interpolation with glyph visualization
• HTC Example: Convection boundary condition interpolation (HTC + bulk fluid temperature)

Each example includes:

• Sample mesh files
• Sample data files
• Jupyter notebook with full workflow
• Visualization with PyVista

Configuration Options

Query Methods

• QUERY_TYPE.K: K-nearest neighbors (param = number of neighbors)
• QUERY_TYPE.RADIUS: Radius-based search (param = radius in same unit as coordinates)

Interpolation Kernels

Source-to-target

Each source point is distributed to destination neighbours:

• DISTANCE_WEIGHTED: Weight by inverse distance
• FEM: FEM-based interpolation

Target-to-source

A value is assigned to each destination point based on source neighbours

• CLOSEST: Use closest source point value
• AVERAGE: Simple average of neighbors
• AVERAGE_WEIGHTED: Average the neighbours values but weighting them by distance (the closer the more important).

Load Types

• EM_FORCE: 3-component vector fields (Fx, Fy, Fz). If "vol" column is provided the forces are interpreted as force densities and will be multiplied by the volume.
• HEAT_FLUX: Scalar fields for surface heat flux
• HEAT_GEN: Scalar fields for volumetric heat generation
• HTC: 2-component convection boundary condition — Heat Transfer Coefficient and bulk fluid (reference) temperature. Exported as SFE,,CONV,1 and SFE,,CONV,2 in APDL.

File Format

The file format is pretty free, header, no header, commas, tabs.... The important part is that the correct index columns are specified when creating the interpolator.

Destination mesh input files can be created using the apdl scripts included in this repository here.

Requirements

• Python ≥ 3.10
• scikit-learn
• pandas
• tqdm
• pyvista

License

Licensed under the European Union Public Licence (EUPL) 1.2

Authors

Developed by the F4E mechanical team