PurkinjeUV: Scientific Python Package for Cardiac Simulation

Problem

Computational modeling workflows need reusable, testable, documented package code instead of fragile research scripts.

Solution

Built a modular scientific Python package for generating Purkinje-network geometries over cardiac surface meshes, with simulation, visualization, export utilities, documentation, tests, and PyPI packaging.

Deliverables

• Python package
• Fractal network generation
• Mesh support
• UV mapping workflow
• Eikonal solver path
• Visualization utilities
• Docs
• CI
• PyPI release

Why it matters

• Installable package means collaborators reproduce results without re-reading your setup notes
• PyPI release makes the work citable and verifiable outside the lab
• Fractal generation + UV mapping handles geometry that pure FEM mesh tools cannot address
• Tests + CI keep the package reliable as scientific dependencies evolve