matgl-framework

MatGL Framework

Description

Use this skill when building, applying, validating, or fine-tuning MatGL models for materials property prediction, learned interatomic potentials, and graph-based materials workflows. MatGL is most useful when a workflow needs pretrained graph neural network models, pymatgen-compatible structure handling, periodic crystal graph construction, or a bridge between materials databases, DFT datasets, and learned potential deployment.

MatGL should not be treated as a black-box replacement for DFT. Pretrained models can be extremely useful for screening, relaxation preconditioning, or baseline predictions, but their reliability depends on the training domain, target definition, element coverage, structure type, and validation protocol.

Domain Context

MatGL sits in the materials graph-learning ecosystem alongside M3GNet-style universal potentials, MEGNet-style property models, CHGNet-style charge-informed workflows, and newer pretrained materials models. In practice, it often appears in workflows that start from pymatgen Structure objects, convert periodic structures into graph representations, apply a pretrained model, and then validate predictions against DFT or experiment.

Useful MatGL tasks include:

• Predicting crystal properties from periodic structures.
• Loading pretrained models for formation energy, band gap, or potential-energy-surface inference where available.
• Relaxing structures using learned energy/force/stress models.
• Fine-tuning pretrained models on project-specific DFT datasets.
• Preparing graph-learning baselines for high-throughput screening.
• Comparing universal-potential relaxations against VASP, Quantum ESPRESSO, or CP2K reference calculations.

When to Use This Skill

• Use when applying MatGL pretrained models to crystal property prediction, screening, relaxation preconditioning, or potential-energy-surface inference.
• Use when converting pymatgen structures into periodic graph-learning inputs with explicit control over cell representation, cutoffs, neighbor lists, and metadata.
• Use when fine-tuning MatGL or M3GNet-style models on project-specific DFT datasets with energy, force, stress, or scalar property labels.
• Use when comparing MatGL predictions against DFT, high-throughput DFT, universal potentials, or other graph neural network baselines.