chem-sorption-relax

Build minimum-interplanar-distance supercells and relax porous frameworks with MLIPs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ase, numpy, and includes scripts (resource) components.

What problem does it solve?

Porous framework unit cells (MOFs/COFs) often produce unphysical gas self-interactions across periodic boundaries during sorption simulations, so you need a reliable way to expand the cell and then relax the resulting structure before running downstream calculations.

Core Features & Use Cases

  • Minimum interplanar distance supercell building: Automatically checks whether the structure’s interplanar spacing meets a threshold (commonly ≥ 12 Å) and repeats the unit cell when it does not.
  • MLIP-based structural relaxation: Relaxes the (possibly expanded) framework using a supported MLIP backend (via provided relaxation tooling) to produce a stable geometry.
  • Downstream-ready outputs: Produces relaxed CIFs that can be used directly for sorption workflows such as Widom insertion and GCMC.

Quick Start

Run the supercell check-and-build and then relax the framework using an MLIP model so you can feed the relaxed CIF into sorption simulations.

Frequently Asked Questions about chem-sorption-relax

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

FAQPage Schema
Why do I need to expand a MOF supercell before running sorption simulations?

Expanding a MOF supercell prevents unphysical gas self-interactions across periodic boundaries during sorption simulations. This Skill automatically checks if interplanar spacing meets a threshold, commonly 12 Å, and expands the unit cell if needed.

How do I prepare a porous framework for MLIP relaxation and Widom insertion?

To prepare a porous framework for MLIP relaxation and Widom insertion, use this Skill to build a minimum-interplanar-distance supercell from a CIF or XYZ file and then apply the scripted MLIP relaxation toolchain to produce a stable geometry.

Can I use ASE and NumPy to preprocess COF structures for GCMC calculations?

Yes, this Skill uses ASE and NumPy as dependencies to preprocess COF structures for GCMC calculations. It evaluates cell geometry, expands the periodic structure, and outputs relaxed CIF files ready for downstream sorption studies.

What is the best way to fix periodic boundary artifacts in MOF unit cells?

The best way to fix periodic boundary artifacts in MOF unit cells is to generate a supercell with sufficient minimum interplanar distance before relaxation. This Skill automates that expansion check to eliminate unphysical self-interactions.

Does this Skill support relaxing structures using machine learning interatomic potentials?

Yes, this Skill applies a configurable MLIP relaxation toolchain to relax the expanded porous framework. It produces a stable, downstream-ready geometry that can be used directly for molecular sorption calculations.

What file formats are supported for supercell generation in porous framework preprocessing?

This Skill supports CIF and XYZ file formats for supercell generation in porous framework preprocessing. It reads the cell geometry from these inputs to determine if expansion is required before applying MLIP relaxation.