eagar-tsai

Python Platforms

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. Built-in plotting covers 2-D temperature field heatmaps, 3-D temperature volume rendering with PyVista, and power-velocity printability maps.

Report a Bug | Request a Feature | Documentation

Installation

Pre-built binary wheels are published to PyPI for Python 3.12, 3.13, and 3.14 on Linux (x86-64, i686), macOS (x86-64 and Apple Silicon), and Windows (AMD64). If a matching wheel exists for your platform, no C compiler is needed.

# Recommended — using uv
uv add eagar-tsai

# Alternative — using pip
pip install eagar-tsai

[!NOTE] If no pre-built wheel matches your platform (for example, a non-standard Linux architecture or a Python version outside the supported range), the package falls back to building from source. In that case a C compiler is required: GCC or Clang on Linux/macOS; MSVC Build Tools or MinGW-w64 on Windows.

Quick Start

For a single parameter set, use compute_single_point directly:

from eagar_tsai import BeamParameters, MaterialProperties, SimulationDomain, compute_single_point

beam = BeamParameters(
        beam_diameter=100e-6,
        power=200.0,
        velocity=0.5,
        absorptivity=0.35
)

material = MaterialProperties(
        liquidus_temperature=1700.0,
        thermal_conductivity=30.0,
        density=7800.0,
        specific_heat=700.0
)

domain = SimulationDomain(
        x_length_um=1200.0,
        y_length_um=1200.0,
        z_depth_um=1000.0,
        spatial_resolution_um=1.0,
)

result = compute_single_point(beam, material, domain)

print(f"Length: {result.length_um:.1f} µm")
print(f"Width:  {result.width_um:.1f} µm")
print(f"Depth:  {result.depth_um:.1f} µm")

To run multiple parameter sets in parallel, use compute_melt_pool with a DataFrame. 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(
    data=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)
)
print(result[["melt_length_um", "melt_width_um", "melt_depth_um"]])

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	Notes
`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
`temperature_field`	—	`TemperatureField` object; `None` on failure. Pass `return_field=False` to omit.

Temperature Field Visualization

compute_single_point returns a MeltPoolResult that always includes the full TemperatureField and a built-in plot method:

from eagar_tsai import BeamParameters, MaterialProperties, SimulationDomain, compute_single_point

beam = BeamParameters(
        beam_diameter=100e-6,
        power=200.0,
        velocity=0.5,
        absorptivity=0.35
)

material  = MaterialProperties(
        liquidus_temperature=1700.0,
        thermal_conductivity=30.0,
        density=7800.0,
        specific_heat=700.0
)

domain = SimulationDomain(
        x_length_um=320.0,
        y_length_um=110.0,
        z_depth_um=60.0,
        spatial_resolution_um=5.0,
)

result = compute_single_point(
        beam=beam,
        material=material,
        domain=domain
)

print(result.length_um)                        # melt pool length in µm
print(result.temperature_field.T_xy.shape)     # (ny, nx) — surface plane in Kelvin
print(result.temperature_field.T_xz.shape)     # (nz, nx) — depth cross-section in Kelvin

fig = result.plot(output="temperature_field.png") # equivalently: result.temperature_field.plot(output="temperature_field.png")

The standalone convenience function skips constructing the MeltPoolResult object explicitly:

from eagar_tsai.plot import plot_temperature_field

fig = plot_temperature_field(beam, material, domain, output="temperature_field.png")

3-D Temperature Volume

compute_temperature_volume evaluates the full (nx, ny, nz) temperature array on the auto-sized domain and returns a TemperatureVolume. The y axis covers only the half-domain by symmetry; mirror_y=True (the default) reconstructs the full melt pool for rendering and export.

The 3-D computation evaluates the integral at every grid point in the volume. For interactive use, coarser spatial resolution (e.g. spatial_resolution_um=5.0) gives a 25× speed-up over the 1 µm default with minimal loss of shape accuracy.

from eagar_tsai import BeamParameters, MaterialProperties, SimulationDomain
from eagar_tsai import compute_temperature_volume

beam = BeamParameters(
    beam_diameter=80e-6,
    power=250.0,
    velocity=0.5,
    absorptivity=0.59,
)

material = MaterialProperties(
    liquidus_temperature=3455.0,
    thermal_conductivity=23.75,
    density=18038.9,
    specific_heat=251.6,
)

domain = SimulationDomain(
    x_length_um=800.0,
    y_length_um=400.0,
    z_depth_um=300.0,
    spatial_resolution_um=5.0,
)

volume = compute_temperature_volume(beam, material, domain, workers=-1)

print(volume.T_xyz.shape)              # (nx, ny, nz) in Kelvin
print(volume.result.length_um)         # melt pool length from the 2-D auto-sizing step

volume.export_vti("temperature_volume.vti")   # export for ParaView / VisIt

fig = volume.plot_3d()                 # returns a matplotlib Figure
plotter = volume.plot_3d(return_plotter=True)  # interactive PyVista window

The standalone convenience function skips constructing the TemperatureVolume object explicitly:

from eagar_tsai.plot import plot_temperature_field_3d

# Returns a matplotlib Figure by default
fig = plot_temperature_field_3d(beam, material, domain, workers=-1)

# Save the rendered image and also export a .vti file in one call
fig = plot_temperature_field_3d(
    beam, material, domain,
    workers=-1,
    output="volume.png",
    output_vti="volume.vti",
)

# Open an interactive PyVista window
plotter = plot_temperature_field_3d(beam, material, domain, workers=-1, return_plotter=True)

To compute 3-D volumes for multiple parameter sets from a DataFrame, use compute_temperature_volumes:

import pandas as pd
from eagar_tsai import compute_temperature_volumes

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

volumes = compute_temperature_volumes(df, workers=-1)
volumes[0].export_vti("row0_volume.vti")

Printability Maps

compute_printability_map sweeps laser power and scan speed over a regular grid, runs the Eagar–Tsai model at every point, and classifies each point into one of four defect regimes (keyhole porosity, lack of fusion, balling, or defect-free) using the five criteria from Sheikh et al. (2023). Each grid point is dispatched as an independent parallel task, so workers stay fully utilized even when isolated points require iterative domain expansion.

from eagar_tsai import (
    MaterialProperties,
    PrintabilityParameters,
    SimulationDomain,
    compute_printability_map,
)
from eagar_tsai.plot import plot_printability_map

material = MaterialProperties(
    liquidus_temperature=1700.0,
    thermal_conductivity=30.0,
    density=7800.0,
    specific_heat=700.0,
)

process = PrintabilityParameters(
    beam_diameter_m=80e-6,
    absorptivity=0.35,
    layer_thickness_m=40e-6,
    hatch_spacing_m=90e-6,
)

domain = SimulationDomain(
    x_length_um=1200.0,
    y_length_um=1200.0,
    z_depth_um=1000.0,
    spatial_resolution_um=5.0,  # coarser grid, ~25x faster than 1 µm
)

# Raw data: one row per grid point with defect classification
df = compute_printability_map(
    process,
    material,
    power_range=(50.0, 400.0),
    velocity_range=(0.1, 3.0),
    n_power=50,
    n_velocity=50,
    domain=domain,
    workers=-1,  # use all CPU cores
)

print(df["defect"].value_counts())

# Or render directly as a color-coded figure
fig = plot_printability_map(
    process,
    material,
    power_range=(50.0, 400.0),
    velocity_range=(0.1, 3.0),
    n_power=50,
    n_velocity=50,
    domain=domain,
    workers=-1,
    output="printability_map.png",
)

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.

Citation

We are currently preparing a preprint for publication. If you use eagar-tsai in your research, please cite the following:

Sarıtürk, D., & Vela, B. (2026). eagar-tsai. Zenodo. https://doi.org/10.5281/zenodo.19837225

BibTeX:

@software{sariturk_2026_19837225,
  author    = {Sarıtürk, Doğuhan and Vela, Brent},
  title     = {eagar-tsai},
  year      = 2026,
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.19837225},
  url       = {https://doi.org/10.5281/zenodo.19837225},
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eagar_tsai-0.4.2.tar.gz (48.7 kB view details)

Uploaded Aug 27, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

eagar_tsai-0.4.2-cp314-cp314-win_amd64.whl (46.8 kB view details)

Uploaded Aug 27, 2026 CPython 3.14Windows x86-64

eagar_tsai-0.4.2-cp314-cp314-win32.whl (46.5 kB view details)

Uploaded Aug 27, 2026 CPython 3.14Windows x86

eagar_tsai-0.4.2-cp314-cp314-musllinux_1_2_x86_64.whl (49.4 kB view details)

Uploaded Aug 27, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

eagar_tsai-0.4.2-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (49.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.14manylinux: glibc 2.28+ x86-64manylinux: glibc 2.5+ x86-64

eagar_tsai-0.4.2-cp314-cp314-macosx_11_0_arm64.whl (43.7 kB view details)

Uploaded Aug 27, 2026 CPython 3.14macOS 11.0+ ARM64

eagar_tsai-0.4.2-cp314-cp314-macosx_10_15_x86_64.whl (43.4 kB view details)

Uploaded Aug 27, 2026 CPython 3.14macOS 10.15+ x86-64

eagar_tsai-0.4.2-cp313-cp313-win_amd64.whl (46.5 kB view details)

Uploaded Aug 27, 2026 CPython 3.13Windows x86-64

eagar_tsai-0.4.2-cp313-cp313-win32.whl (46.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.13Windows x86

eagar_tsai-0.4.2-cp313-cp313-musllinux_1_2_x86_64.whl (49.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

eagar_tsai-0.4.2-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (49.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.13manylinux: glibc 2.28+ x86-64manylinux: glibc 2.5+ x86-64

eagar_tsai-0.4.2-cp313-cp313-macosx_11_0_arm64.whl (43.7 kB view details)

Uploaded Aug 27, 2026 CPython 3.13macOS 11.0+ ARM64

eagar_tsai-0.4.2-cp313-cp313-macosx_10_13_x86_64.whl (43.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.13macOS 10.13+ x86-64

eagar_tsai-0.4.2-cp312-cp312-win_amd64.whl (46.5 kB view details)

Uploaded Aug 27, 2026 CPython 3.12Windows x86-64

eagar_tsai-0.4.2-cp312-cp312-win32.whl (46.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.12Windows x86

eagar_tsai-0.4.2-cp312-cp312-musllinux_1_2_x86_64.whl (49.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

eagar_tsai-0.4.2-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl (49.2 kB view details)

Uploaded Aug 27, 2026 CPython 3.12manylinux: glibc 2.28+ x86-64manylinux: glibc 2.5+ x86-64

eagar_tsai-0.4.2-cp312-cp312-macosx_11_0_arm64.whl (43.6 kB view details)

Uploaded Aug 27, 2026 CPython 3.12macOS 11.0+ ARM64

eagar_tsai-0.4.2-cp312-cp312-macosx_10_13_x86_64.whl (43.3 kB view details)

Uploaded Aug 27, 2026 CPython 3.12macOS 10.13+ x86-64

File details

Details for the file eagar_tsai-0.4.2.tar.gz.

File metadata

Download URL: eagar_tsai-0.4.2.tar.gz
Upload date: Aug 27, 2026
Size: 48.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for eagar_tsai-0.4.2.tar.gz
Algorithm	Hash digest
SHA256	`02b4c0b4c1f3040892690215425dc40d12e517bca0c7c8ea555122d81069a195`
MD5	`b7175ff2b91bc384d0cdb0fef9093ddb`
BLAKE2b-256	`95c5639b838f1ebe0f464c3b8ea0681f7e3635dc2e92110f61bfd266f375b5f2`

Algorithm	Hash digest
SHA256	`a03dd8f59a64e529948fdafc7c82ec2bc90263b087b7c6dc9ba903d47e690cda`
MD5	`895defd7bc7a697a359e805b3b722601`
BLAKE2b-256	`4aab8f54a9dbdda0079915220c16c594499b9f68bac351d445fc0b6117931326`

Algorithm	Hash digest
SHA256	`4d7df1117c7b61082bc8f17d0ab365d2918d6ad69e1b1596c773eb4c977eee5d`
MD5	`169a916d9f70525383ac5b1676042931`
BLAKE2b-256	`2dcbca0362e1ad8c14da86f5f7b2a276146223fd543f0175000d7f0bd25a626d`

Algorithm	Hash digest
SHA256	`0d82082a6d833324bec3b87b87015e3c9eeac3a2eb11d26f6aee30a22318943d`
MD5	`a7996695362ffbab0c63f341418cfc64`
BLAKE2b-256	`a08576a7e89e16bdf97c61722779d18701b43118f52f5f85bb7460419a94ec79`

Algorithm	Hash digest
SHA256	`f2199aaedea96f456b8573df55a5bcddbe8c98c126b5235ad777774e9ef69f2e`
MD5	`6e7fbeccea9346d05576c844fa16b49a`
BLAKE2b-256	`cfc365663ee280bb158aad2884804f22fe4470b3e50d4572211fd934cb7b29de`

Algorithm	Hash digest
SHA256	`6bde4ed833d576f2cc68c288a1d61a6445fa16d8d509dcdc8fb322043e7ae7aa`
MD5	`32bd81d2fa95c470284a3aa28b238043`
BLAKE2b-256	`9ff9e3ee466adce9ce1c9c0a562e757f6052312ab42a840b270fc3404581fe70`

Algorithm	Hash digest
SHA256	`0014c68e469a3db81a598dd73829dc61fc42c5a32e544f7e8af01bc70d0cf10d`
MD5	`44af79897aa43ff56768bd4d395a6b97`
BLAKE2b-256	`46634946c73df6259e8c797f1c117835cc48c39f13c456edb69a5c2162465bbc`

Algorithm	Hash digest
SHA256	`b93756704a351da62c5e5bbbe11a1be465b1c7c6ca984423bccd49b4791be147`
MD5	`216bca494795599dc7718aa021b8414a`
BLAKE2b-256	`ac6cde4ac684d0da58d67b76c6f86c5c7b9aea890ad7ca45a3ceb13bccd8b632`

Algorithm	Hash digest
SHA256	`201dc8fc3cb6501062d099d94cd2522be9ef5a7b999c864ce6b60bc5de8c0d17`
MD5	`6f9c4c312c3b80b0502297c47f0fd99e`
BLAKE2b-256	`ed7f4741211c2f084ac73d30ac09320dd44a805e9bb3f2f483e5b321eec17f8f`

Algorithm	Hash digest
SHA256	`ef4c1b99c9ade0b43d3f0cb57e78cefefbac24afd3bebeaf17253a946f897780`
MD5	`17af88d8d8b318e4056d7f543a19e53c`
BLAKE2b-256	`6b901e1cd91050a9fb157479dac0321f857a80d0f0e35a7e307314a953833a61`

Algorithm	Hash digest
SHA256	`a8e553809170562ea9019e3f235e2f83a5c611a47b752687b4884fba1603ca9d`
MD5	`2ecb7bdc34325f6b4a400efbe157c306`
BLAKE2b-256	`6760bcf6d3a07918ec3b96918a0e87381518789f5852f2f2d85cc35b7d47cb5d`

Algorithm	Hash digest
SHA256	`a842a330f61e260b89aef8a2e27532a991f948237932f3b789c6a778929c287c`
MD5	`effecd8059d2aac7c6f90b37ce1d24d5`
BLAKE2b-256	`fe1ebfb2c458c22091dafa747a7a044954bce12a28fa059741b5404c7909cc5d`

Algorithm	Hash digest
SHA256	`189726de6a2c5d7b984adf1ec9f134e68be139346369a962a556063016e2e12b`
MD5	`1137e6b060ea5a4c430e20b9b043a1e5`
BLAKE2b-256	`188d7e2d8b0a538b3f25545f50206fbc8c739a2ac206294793e69daa8fced16b`

Algorithm	Hash digest
SHA256	`fb0cf8e57489ef1c727c654f7b7484fdb0b9b3ac3713a57b1ad56225ac888563`
MD5	`6ade90684897bc2c67520bb84f33ac7d`
BLAKE2b-256	`835123834c6fea03c26fd2506efcf61de4b97554c897112557129579ef3adc4c`

Algorithm	Hash digest
SHA256	`7ef46b647ac028a373c252a03f044cf00c8dfbaf6955c1cdd9c6453fb60e2a15`
MD5	`fbf574a4a782448fcb7dd515c0f82b34`
BLAKE2b-256	`3e99e267509cb0922f7b66f5fa43ca7ad1e48dd522d5574bc8f179e0a5ee0a94`

Algorithm	Hash digest
SHA256	`ec468aab2549a6c82e873514d858f00197d5921d82cf21f1ee1be8262b167118`
MD5	`a46c4850ea5a287b8b40039923128e01`
BLAKE2b-256	`1904306c9441ae0ebc112ebc43864c75c8f7812009dae3cbcd61a3af4815cb8f`

Algorithm	Hash digest
SHA256	`8dacb4008222109cd4e78b9ac5a46ced12b52336b65447ff79299cc328d0ca7d`
MD5	`fcd77cd04e629e62b63e4a63b2376040`
BLAKE2b-256	`2394aa7ac175722ae5a31741dec8f920123a3aed1801c732685cfa009ab457f0`

Algorithm	Hash digest
SHA256	`a8416e4e2dfb91f5e0812c7dd723dad86494e6f0b4828c9c0d72168b945e13d4`
MD5	`e54520fa10d641c34f05bb61805e558b`
BLAKE2b-256	`46c42f44314087f2cad9d5ae117a1698b584bd7ae18a84c83b5a25e2579f7c96`

Algorithm	Hash digest
SHA256	`90c37f56bf0d209e0e3ae742746d4a84fd2665834af2fd886f65126f67057128`
MD5	`668bbbbb05bbf5dc0d30e1b16beee8ef`
BLAKE2b-256	`93c7b3ba4c323873b1d62dd61fb17eb7e6c490c3ab3e8db9806faa1a510e5659`

eagar-tsai 0.4.2

eagar-tsai

Installation

Quick Start

Required Input Columns

Output Columns Added to the DataFrame

Temperature Field Visualization

3-D Temperature Volume

Printability Maps

References

License

Citation

Key dates

1 maintainer

Credits

License expression

Requires

Provides Extra

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes