mat-qha-thermal-expansion

Calculate QHA thermal properties by fitting an equation of state and evaluating MLIP vibrational contributions.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill mat-qha-thermal-expansion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mat-qha-thermal-expansion
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/mat-qha-thermal-expansion
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill mat-qha-thermal-expansion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Predicting temperature-dependent lattice thermal expansion and Gibbs free energy is difficult to compute manually, especially when accurate vibrational properties are needed for many temperatures.

Core Features & Use Cases

  • Quasi-Harmonic Approximation (QHA) thermodynamics: Computes temperature-dependent Gibbs energy and thermal expansion using MLIP-based vibrational calculations.
  • Equation-of-state (EOS) support: Fits an EOS (e.g., Vinet) to enable QHA calculations across a specified temperature range.
  • MLIP model compatibility: Uses supported MLIP wrappers to access forces and vibrational stability for QHA-ready potentials.
  • Practical outputs for research: Produces gibbs_temperature.dat and thermal_expansion.dat plus a qha_results.json summary for downstream analysis.

Quick Start

Use the mat-qha-thermal-expansion skill to calculate QHA thermal properties for your relaxed structure file using a selected MLIP model wrapper and EOS, saving gibbs_temperature.dat and thermal_expansion.dat to your output directory.

Frequently Asked Questions about mat-qha-thermal-expansion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate thermal expansion using machine learning interatomic potentials?

To calculate thermal expansion using machine learning interatomic potentials, you can use a quasi-harmonic approximation workflow that fits an equation of state and evaluates MLIP-derived vibrational contributions across a temperature grid. This script requires a relaxed structure file, a selected MLIP wrapper, and an EOS model to generate temperature-dependent thermal expansion data.

How does the quasi-harmonic approximation predict temperature-dependent Gibbs energy for solids?

The quasi-harmonic approximation predicts temperature-dependent Gibbs energy by fitting an equation of state, such as Vinet, to MLIP-derived vibrational calculations. This method evaluates phonon contributions across a user-defined temperature grid to accurately compute Gibbs free energy for solid materials.

Can I use MACE or MatGL models to compute QHA thermal properties?

Yes, you can compute QHA thermal properties using MACE or MatGL models. The script supports selecting QHA-stable MLIP wrappers including MACEWrapper, MatGLWrapper, and FAIRCHEMWrapper to access the forces and vibrational stability required for the calculations.

What files do I need to run a quasi-harmonic thermal expansion calculation?

To run the quasi-harmonic thermal expansion calculation, you need a relaxed structure file, an MLIP model type, an EOS fitting method, and an output directory. The script processes these inputs to generate gibbs_temperature.dat, thermal_expansion.dat, and a qha_results.json summary.

What is the best way to get volumetric thermal expansion data over a specific temperature range?

The best way to get volumetric thermal expansion data over a specific temperature range is to run a QHA script that applies an equation of state and MLIP-derived phonon calculations across a user-defined temperature grid. This approach outputs thermal_expansion.dat files containing the volumetric expansion coefficients.

Are there limitations when using MLIP wrappers for QHA thermodynamics?

A key limitation for QHA thermodynamics is that the chosen MLIP wrapper must be QHA-stable to ensure accurate vibrational calculations. If the potential lacks proper force evaluation or vibrational stability, the fitted equation of state and resulting Gibbs energy predictions may be invalid.