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.