eagar-tsai 0.1.0

Eagar–Tsai moving heat source model for melt pool dimension estimation

eagar-tsai

eagar-tsai is a Python library implementing the Eagar–Tsai moving heat source model to estimate melt pool dimensions (length, width, depth) for a scanning laser over a semi-infinite solid. Temperature fields are computed via a 1D integral; melt pool dimensions are extracted from the liquidus isotherm.

Report a Bug | Request a Feature | Documentation

---

Installation

[!NOTE] A C compiler is required: GCC or Clang on Linux/macOS; MSVC Build Tools or MinGW-w64 on Windows. The C extension is compiled automatically during installation.

# Recommended — using uv
uv add eagar-tsai

# Alternative — using pip
pip install eagar-tsai

---

Quick Start

compute_melt_pool requires a DataFrame with the columns below; workers, chunk_size, and output_dir are optional:

import pandas as pd
from eagar_tsai import compute_melt_pool

df = pd.DataFrame({
    "velocity_m_s":              [0.5],
    "power_w":                   [200.0],
    "beam_diameter_m":           [100e-6],
    "absorptivity":              [0.35],
    "liquidus_temperature_k":    [1700.0],
    "thermal_conductivity_w_mk": [30.0],
    "density_kg_m3":             [7800.0],
    "specific_heat_j_kgk":       [700.0],
})

result = compute_melt_pool(df)
print(result[["melt_length_um", "melt_width_um", "melt_depth_um"]])

Commonly overridden parameters:

result = compute_melt_pool(
    df,
    workers=4,                # parallel worker processes (default: None, serial)
    chunk_size=50,            # rows per worker chunk (default: 50)
    output_dir="CalcFiles/",  # write per-chunk CSVs (default: None)
)

Required Input Columns

Column	Unit	Description
velocity_m_s	m/s	Scan velocity
power_w	W	Laser power
beam_diameter_m	m	Beam diameter (2σ)
absorptivity	—	Absorptivity (0, 1]
liquidus_temperature_k	K	Liquidus temperature
thermal_conductivity_w_mk	W/(m·K)	Thermal conductivity at liquidus
density_kg_m3	kg/m³	Density
specific_heat_j_kgk	J/(kg·K)	Specific heat at liquidus

Output Columns Added to the DataFrame

Column	Unit
melt_length	m
melt_width	m
melt_depth	m
melt_length_um	µm
melt_width_um	µm
melt_depth_um	µm
peak_temperature	K
min_temperature	K

---

References

• T. W. Eagar and N.-S. Tsai, "Temperature Fields Produced by Traveling Distributed Heat Sources," Welding Journal (Research Supplement), December 1983, pp. 346-s–354-s.
• C integrand reformulation: Sasha Rubenchik, LLNL, 2015.

---

License

This project is licensed under the GNU GPLv3 License. See the LICENSE file for details.