mace-screening-and-relaxation

Run MACE-based geometry relaxation and energy ranking on structure batches.

13|1|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/q734738781/CatMaster --skill mace-screening-and-relaxation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mace-screening-and-relaxation
Source: https://github.com/q734738781/CatMaster/tree/main/skills/mace-screening-and-relaxation
Command: npx skills add https://github.com/q734738781/CatMaster --skill mace-screening-and-relaxation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents expensive DFT runs on low-value candidates by providing a fast, MACE-based screening and relaxation loop that prunes structures and produces concise handoff evidence for downstream VASP workflows.

Core Features & Use Cases

  • Fast geometry cleanup and ranking using mace_relax_batch for relaxations and mace_sp_batch for single-point energy evaluations.
  • Robust batching semantics that stage outputs under a separate output_root, collect batch_state_rel and batch_summary_rel, and preserve stdout/stderr/status artifacts for post-mortem inspection.
  • Reproducible handoffs with explicit control of model, head, dispersion, and relax_lattice options, and guidance to keep dispersion settings consistent for adsorption-energy comparisons.
  • Use Case: Screen a slab+adsorbate candidate pool to shortlist structures for final VASP relaxations and adsorption-energy calculations while avoiding unnecessary compute cost.

Quick Start

Run a MACE relax or single-point batch with mace_relax_batch or mace_sp_batch on your input_dir, place output_root outside input_dir, and use the produced batch_state_rel to decide which candidates to send to VASP.

Frequently Asked Questions about mace-screening-and-relaxation

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

FAQPage Schema
How do I screen structure batches before running expensive DFT calculations?▼

You can use MACE-based rapid screening to relax or evaluate structure batches, pruning low-value candidates before committing to DFT. It applies mace_relax_batch for geometry relaxation and mace_sp_batch for energy-only ranking to shortlist structures.

What is the best way to prepare slab adsorption candidates for final VASP relaxations?▼

Pre-DFT screening with MACE allows you to process a slab and adsorbate candidate pool quickly. By running batch relaxations first, you generate concise handoff evidence and avoid unnecessary VASP compute cost on unsuitable structures.

How do I ensure reproducible handoffs when using MACE for pre-DFT geometry cleanup?▼

Reproducible handoffs require explicit control of model, head, dispersion, and relax_lattice options. Keeping dispersion settings consistent is essential for accurate adsorption-energy comparisons across your batched structure outputs.

Does MACE batch screening separate input and output directories for structure relaxation?▼

Yes, MACE batch screening enforces separate input and output trees. You must place the output_root outside the input_dir, ensuring batch_state_rel and batch_summary_rel artifacts are cleanly staged for downstream analysis.

Why does my MACE batch relaxation workflow require explicit model and dispersion choices?▼

Explicit model and dispersion choices are required to guarantee reproducible handoffs to downstream DFT workflows. Consistent dispersion settings are specifically needed for reliable adsorption-energy calculations across pruned structure batches.

Can I perform single-point energy evaluations instead of full geometry relaxation with MACE?▼

Yes, you can use mace_sp_batch to perform single-point energy evaluations for rapid ranking instead of full relaxation. This allows fast energy-based pruning of structure batches before sending selected candidates to DFT.