mat-solid-free-energy

Calculate solid Helmholtz free energy via Frenkel-Ladd thermodynamic integration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Calculate the absolute Helmholtz free energy of a crystalline solid at a target temperature (and Gibbs free energy optionally) without manually setting up a full thermodynamic integration pipeline.

Core Features & Use Cases

  • Frenkel-Ladd (TI) free-energy workflow: Builds an integration path between a physical MLIP Hamiltonian and an Einstein-crystal harmonic reference with an analytically known reference free energy.
  • Portable MLIP backends: Runs using wrapper-loaded machine-learning interatomic potentials via src.utils.mlips.loader.load_wrapper(...) and supports MACE, FairChem, and MatGL backends.
  • Quality-controlled switching outputs: Produces both summary results and trace data (forward/backward contributions, lambda schedule, spring constants, MSD) to support reversibility diagnostics.

Quick Start

Run a Frenkel-Ladd free-energy calculation on your pre-equilibrated CIF/POSCAR structure by invoking the provided script with your MLIP backend, model name, temperature, and output directory.

Frequently Asked Questions about mat-solid-free-energy

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

FAQPage Schema
How do I calculate absolute Helmholtz free energy for a crystalline solid using an MLIP?

Frenkel-Ladd thermodynamic integration computes absolute solid free energy by building an integration path between a physical MLIP Hamiltonian and an Einstein-crystal harmonic reference with an analytically known free energy.

What machine-learning interatomic potential backends are supported for thermodynamic integration?

Thermodynamic integration supports portable MLIP backends loaded via a wrapper, specifically including MACE, FairChem, and MatGL for running the free-energy calculations on periodic crystalline solids.

Can I compute Gibbs free energy at a specific pressure with Frenkel-Ladd integration?

Yes, you can optionally compute Gibbs free energy at a specified pressure by invoking the Frenkel-Ladd thermodynamic integration script with an optional pressure parameter alongside your target temperature.

How do I run Frenkel-Ladd free-energy calculations on a pre-equilibrated structure?

Run the provided script on your pre-equilibrated CIF or POSCAR structure by specifying your MLIP backend, model name, target temperature, and output directory to execute the Frenkel-Ladd thermodynamic integration automatically.

What diagnostic outputs are generated to verify thermodynamic integration reversibility?

The workflow produces summary results and trace data including forward and backward contributions, the lambda schedule, spring constants, and mean square displacement to support quality-controlled switching and reversibility diagnostics.