chem-sorption-gcmc

Run BVT/GCMC Monte Carlo adsorption isotherm calculations with MLIPs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ase, ase-mc, numpy, matplotlib, scipy, torch, and includes scripts (resource) and examples (resource) components.

What problem does it solve?

This Skill removes the manual effort of setting up and running adsorption-isotherm simulations for porous materials by automatically executing MLIP-based GCMC calculations and generating uptake/convergence outputs.

Core Features & Use Cases

  • Grand Canonical Monte Carlo (GCMC) for host–guest adsorption in porous frameworks using an MLIP backend (MACE, FairChem, MatGL).
  • Isotherm point predictions for a single gas at a target temperature/pressure, producing molecule-count and energy traces plus a results JSON.
  • Competitive adsorption for a gas mixture via multi-component GCMC to model separation/selectivity at given partial pressures.

Quick Start

Use the chem-sorption-gcmc skill to run a single-component GCMC isotherm point for CO2 at 298 K and 1 bar on a relaxed porous framework CIF file.

Frequently Asked Questions about chem-sorption-gcmc

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

FAQPage Schema
How do I predict gas adsorption isotherms in porous materials using machine learning potentials?▼

You can predict gas adsorption isotherms by running MLIP-based GCMC Monte Carlo simulations on a relaxed framework structure, which calculates host–guest and guest–guest interactions to produce uptake points and energy traces.

Can I simulate competitive adsorption for gas mixtures in porous frameworks?▼

Yes, you can simulate competitive adsorption for gas mixtures by running multi-component GCMC to model separation and selectivity at specified temperatures, partial pressures, and gas compositions.

What input files do I need to run GCMC adsorption calculations?▼

You need a relaxed framework structure in CIF or XYZ format and a supported MLIP calculator with model checkpoints, such as MACE, FairChem, or MatGL, to execute the GCMC adsorption calculations.

Does this GCMC simulation method work with MACE and FairChem calculators?▼

Yes, the GCMC simulation method supports MACE, FairChem, and MatGL as MLIP calculator backends to evaluate host–guest and guest–guest interactions during the Monte Carlo sampling process.

What outputs do I get from an MLIP GCMC isotherm point prediction?▼

MLIP GCMC isotherm point predictions produce trajectory-derived molecule-count and energy traces, convergence checks, and JSON/plot artifacts detailing the adsorption uptake results.