<img src="https://github.com/djsilva99/heatrapy/blob/master/img/heatrapy.png" height="28" align="center"> heatrapy

Heatrapy is a lightweight Python framework for simulating heat transfer using finite-difference methods, with built-in support for phase transitions and caloric materials.

Features:

• ✅ Easy to learn
• ✅ Finite-difference heat transfer solver
• ✅ 1D and 2D thermal simulations
• ✅ Phase-change materials
• ✅ Caloric effects modeling
• ✅ Multi-material systems
• ✅ Real-time visualization
• ✅ Pure Python implementation

🚀 Why Heatrapy?

Heatrapy makes thermal simulations accessible without heavy FEM or CFD frameworks.

Perfect for:

• Research prototypes
• Teaching heat transfer
• Rapid thermal modeling
• Solid-state cooling simulations

🎬 Example Simulation

⚡ Quick Installation

To install heatrapy use the pip package manager:

$ pip install heatrapy

To import the heatrapy module type in the python shell:

>>> import heatrapy as htp

See the example above or explore the documentation for complete tutorials.

📖 Documentation

Full documentation available here

🤝 Contributions

Contributions of all kinds are welcome!

Please see the development workflow here.

If heatrapy contributes to research that leads to a publication, please cite <a href='https://www.sciencedirect.com/science/article/pii/S2352711018301298'>this paper</a>.

⭐ If you find heatrapy useful, consider starring the repository to support the project.